Nano Payment Gateway

Fast and scalable payment gateway for Nano cryptocurrency

Summary:

• Create and read invoices through REST API
• Detect payment transactions through Nano node websocket
• Receive payment amount and send to merchant account through Nano node RPC
• Notify customers through websocket
• Notify merchants through webhook

Technologies

• Nano: Instant, descentralized, zero fee cryptocurrency.
• Cloudflare Workers: Fast, cheap and scalable serverless functions on the EDGE
• Cloudflare Queues: Send and receive messages with guaranteed delivery inside Cloudflare Workers.
• Supabase: Open source Firebase alternative with a Postgres database accessible through REST API

Requirements

• Requires a Cloudflare Workers account with queue support
• Requires a Supabase account with a transactions table [TODO: Add table model]
• Requires npm installed, wrangler logged and curl for testing

Configure

1. Install packages dependencies:

npm install

2. Create the queues:

wrangler queues create payment-listener-queue
wrangler queues create payment-write-queue
wrangler queues create payment-receiver-queue
wrangler queues create payment-sender-queue
wrangler queues create webhook-delivery-queue
wrangler queues create webhook-delivery-write-queue

3. Publish to Cloudflare. It will generate an url for your gateway:

wangler publish

4. Add environments:

# A secure authentication token
wrangler secret put AUTH_TOKEN

# Your Supabase credentials
wrangler secret put SUPABASE_URL
wrangler secret put SUPABASE_SECRET_KEY

# Your Nano seed for hot wallet (64 hex characters)
wrangler secret put HOT_WALLET_SEED

# A Nano node websocket url
wrangler secret put NANO_WEBSOCKET_URL

# A Nano representative account
wrangler secret put REPRESENTATIVE

# A Nano node RPC url
wrangler secret put RPC_URL

# A Nano node worker RPC url with PoW generation support (can be the same as RPC_URL)
wrangler secret put WORKER_URLS

Running locally

npm start

Deploy

wrangler deploy

Using

5. Add an account to the queue:

• Replace the Bearer with your token
• Replace the account
• expiresAt can be an ISO date or an unix timestamp (in ms)

curl --request POST \
  --url https://payment-gateway.example.workers.dev/ \
  --header 'Authorization: Bearer my-secure-auth-token-here' \
  --header 'Content-Type: application/json' \
  --data '{
        "invoiceId": 3443,
        "to": "nano_1ejctmay4x59368tnbgzsrj7tmzru8ghe6af4rewxtddejsu6d78esb9aar",
        "expiresAt": "2023-02-27T03:46:53.374Z"
    }'

Success response [200]:

{
	"message": "Sent to queue"
}

6. Send a small amount of nano (at least 0.000001 XNO) to the address before expiring and check your supabase table "transactions".

Important! Even if the initial request succeeds, the gateway may fail if you don't configure your websocket node or subbase correctly. So check your Cloudflare Workers logs.