safer-nostr

Safer Nostr is a service that helps protect users by loading sensitive information (IP leak) and using AI to prevent inappropriate images from being uploaded. It also offers image optimization and storage options. It has configurable privacy and storage settings, as well as custom cache expiration.

Key features

• Load NIP-05
• Load website preview
• Cache texts
  • Cache in Redis
  • Cache in RAM
• Load and optimize Medias
  • Store in Redis
  • Store in RAM
  • Store in S3
  • Store in local disk
  • Artificial intelligence checks for inappropriate images
  • Artificial intelligence checks for inappropriate gifs
  • Artificial intelligence checks for inappropriate videos
• Formats
  • JPG
  • PNG
  • GIF
  • MP4
  • WEBP
• Configurable settings
  • Private or public mode
  • Private mode: Public key verification
  • Private mode: Password verification
  • RAM or Redis storage options
  • Custom cache expiration time
  • Bitcoin or Lightning Bitcoin payment 1 time or recurrent to be in the allowlist

API's

For server that requires authentication with public key

You can only make one authenticated request with the same signature.

Parameter	Type	Description	Example	Is required?
pubkey	string	Your public key	884704bd421721e292edbff42eb77547fe115c6ff9825b08fc366be4cd69e9f6	yes
uniq	string	a unique (random) string	20	yes
time	number	Unix timestamp (UTC-0)	1600000000	yes
sig	string	Signature of: sha256(string: "{pubkey}:{time}:{uniq}"")	0ae1feeb6fb36f3f5f5d3f001b06a5f6d01c999d7a74b9227012cdac0587f1ef7b9ed4b5e16afd3f1f502266f0b3b2ed21906554d6e4ffba43de2bb99d061694	yes
sig	string	pubkey	884704bd421721e292edbff42eb77547fe115c6ff9825b08fc366be4cd69e9f6	yes

For server that requires authentication with password

Parameter	Type	Description	Example	Is required?
pass	string	Your password	helloworld	yes

GET /is_good

Check if the server is ok with your password / sig / nothing

type IsGoodResponse = "Yes!" | "Access Denied";

GET /nip05

Example without Authentification required: https://example.com/nip05?nip05=_@nostr.0xtlt.dev Example with password Authentification required: https://example.com/nip05?nip05=_@nostr.0xtlt.dev&pass=helloworld Example with pubkey Authentification required: https://example.com/nip05?nip05=_@nostr.0xtlt.dev&pubkey=884704bd421721e292edbff42eb77547fe115c6ff9825b08fc366be4cd69e9f6&uniq=20&time=1600000000&sig=0ae1feeb6fb36f3f5f5d3f001b06a5f6d01c999d7a74b9227012cdac0587f1ef7b9ed4b5e16afd3f1f502266f0b3b2ed21906554d6e4ffba43de2bb99d061694

Parameter	Type	Description	Example	Is required?
nip05	string	NIP-05 to load	_@nostr.0xtlt.dev	yes

Response type:

type NIP05Response = {
  status: "error";
  message: string;
} | {
  pubkey: string;
  status: "success";
  updated_at: number;
}

GET /image_proxy

Example without Authentification required: https://example.com/image_proxy?url=https://example.com/image.png&width=800&ratio=16:9 Example with Authentification required: https://example.com/image_proxy?url=https://example.com/image.png&width=800&ratio=16:9&pubkey=884704bd421721e292edbff42eb77547fe115c6ff9825b08fc366be4cd69e9f6&uniq=20&time=1600000000&sig=0ae1feeb6fb36f3f5f5d3f001b06a5f6d01c999d7a74b9227012cdac0587f1ef7b9ed4b5e16afd3f1f502266f0b3b2ed21906554d6e4ffba43de2bb99d061694

Parameter	Type	Description	Example	Is required?
url	string	URL of the image to load	https://example.com/image.png	yes
width	number	Width of the image	100	no
height	number	Height of the image	100	no
ratio	string	Ratio of the image	1:1	no

Response type: An image

GET /website_preview

Example without Authentification required: https://example.com/website_preview?url=https://example.com Example with Authentification required: https://example.com/website_preview?url=https://example.com&pubkey=884704bd421721e292edbff42eb77547fe115c6ff9825b08fc366be4cd69e9f6&uniq=20&time=1600000000&sig=0ae1feeb6fb36f3f5f5d3f001b06a5f6d01c999d7a74b9227012cdac0587f1ef7b9ed4b5e16afd3f1f502266f0b3b2ed21906554d6e4ffba43de2bb99d061694

Parameter	Type	Description	Example	Is required?
url	string	URL of the website to load	https://example.com	yes

Response type:

type WebsitePreviewResponse = {
  title: string;
  description: string;
  image: string;
}