close
Skip to content

onmax/nimiq-sky

Repository files navigation

Nimiq Sky (NuxtHub)

Single Nuxt 4 + NuxtHub mini-app meant to run inside Nimiq Pay.

Client-only wallet flow:

  • Unlock with Nimiq key
  • Deterministically create/sign in to AT Protocol account
  • Publish posts to Bluesky-compatible PDS

Dev

pnpm install
pnpm dev

Then open the URL in Nimiq Pay's mini-app browser.

Env

  • NUXT_PUBLIC_ATPROTO_SERVICE (required)

Example:

NUXT_PUBLIC_ATPROTO_SERVICE=https://your-pds.example

For wallet-only provisioning, the configured PDS must allow open account creation:

  • inviteCodeRequired must be false
  • phoneVerificationRequired must not be true

Validate your PDS with com.atproto.server.describeServer:

curl -s "$NUXT_PUBLIC_ATPROTO_SERVICE/xrpc/com.atproto.server.describeServer" | jq '{inviteCodeRequired, phoneVerificationRequired, availableUserDomains}'

Deployment Checklist

  1. Configure NUXT_PUBLIC_ATPROTO_SERVICE to a PDS that allows wallet-only provisioning.
  2. Run the compatibility guard:
pnpm check:pds
  1. Deploy only after the guard returns success:
pnpm cf:deploy

Compatibility contract:

  • inviteCodeRequired must be false
  • phoneVerificationRequired must not be true

As of February 16, 2026, https://bsky.social is not compatible for wallet-only provisioning because it reports phoneVerificationRequired: true.

Troubleshooting

  • PDS_CHECK_ERROR Missing NUXT_PUBLIC_ATPROTO_SERVICE...
    • Set NUXT_PUBLIC_ATPROTO_SERVICE in env or wrangler.jsonc vars.
  • PDS_CHECK_ERROR Invalid NUXT_PUBLIC_ATPROTO_SERVICE URL...
    • Use a valid https://... URL.
  • PDS_CHECK_ERROR Failed to reach describeServer endpoint...
    • Confirm the PDS URL is reachable from your deployment environment.
  • PDS_CHECK_ERROR describeServer returned non-JSON response...
    • Confirm the target is an AT Protocol PDS endpoint.
  • PDS_CHECK result=blocked ... inviteCodeRequired=true or phoneVerificationRequired=true
    • Switch to a PDS that allows open account creation for wallet-only provisioning.

Cloudflare

Build + deploy (Workers + D1 + KV + R2):

pnpm cf:deploy

Bindings live in wrangler.jsonc (DB, KV, BLOB).

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors