@eikeon/nostr-relay-aws

NIP-01 NOSTR relay - AWS serverless implementation (DynamoDB, Lambda, API Gateway WebSocket).

Requires @eikeon/nostr-relay as a peer dependency.

Requirements

• Node.js >= 24.0.0
• AWS account for DynamoDB and API Gateway

CDK Deployment

cd packages/nostr-relay-aws
pnpm cdk bootstrap
pnpm cdk deploy

By default you get the API Gateway URL (wss://{apiId}.execute-api.{region}.amazonaws.com/prod). For a custom domain (e.g. wss://relay.example.com), pass context at deploy time:

pnpm cdk deploy -c domainName=relay.example.com -c certificateArn=arn:aws:acm:us-east-1:ACCOUNT:certificate/ID -c hostedZoneDomain=example.com

You need an ACM certificate in us-east-1 and a Route53 hosted zone for the domain.

With a custom domain, a minimal CloudFront distribution is added to serve NIP-11 relay metadata at the same hostname. Optional NIP-11 context overrides:

pnpm cdk deploy -c domainName=relay.eikeon.com \
  -c certificateArn=arn:aws:acm:us-east-1:ACCOUNT:certificate/ID \
  -c hostedZoneDomain=eikeon.com \
  -c nip11Name="eikeon Learn Relay" \
  -c nip11Description="Interactive vocabulary exercises & multi-learner sessions on Nostr. Visit https://learn.eikeon.com" \
  -c nip11Icon="https://learn.eikeon.com/favicon.ico" \
  -c nip11Contact="https://learn.eikeon.com"

Test NIP-11:

curl -H "Accept: application/nostr+json" https://relay.eikeon.com