Testnet only. Sei Atlantic-2, chain 1328.Not audited. Test funds only.

Concepts

Payment links

Bearer links that carry a private payment, and what happens when two people race for one.

On this page
  1. Format
  2. Claiming
  3. Races
  4. Handling links safely

A payment link holds money the way cash does. The sender pays into a note whose key is derived from a fresh random linkSecret; the link carries that secret. Whoever opens the link can spend the note into their own wallet.

This is not how you ask to be paid. A link already contains the money. To ask someone else to pay you, make a payment request. That link holds no secret and no funds.

Format

https://<app>/c#v1.<chainId>.<pool>.<base64url(tokenId 1B ‖ amount 12B ‖ linkSecret 32B)>
  • Everything after # is the fragment. Browsers never send it to a server, and link-preview bots never see it, so a WhatsApp preview can't leak the secret.
  • The chain id and pool are in the link, so a link can't be replayed against another deployment.
  • The secret is never derived from the sender's seed. A leaked link exposes that one payment and nothing else.

Claiming

When the link opens, the app reads the fragment and immediately removes it from the address bar and history. If the visitor has no wallet, the app makes one first. It then finds the link's note in the tree, proves a transfer from the link note to the claimant's own key, and submits it through the testnet sponsor. The claimant needs no SEI.

The sender's note for the link is also encrypted to the sender, so the sender can see it after a restore, share it again, or take it back while it is unclaimed.

Races

Two claims of the same link spend the same note, so they publish the same nullifier. The first one included wins; the second reverts with NullifierSpent and costs nothing to the loser's balance. The app checks the nullifier before proving and again before submitting, and the relayer refuses a spent or in-flight nullifier before paying gas. These cases are tested on-chain (Spec §10.2).

  • A link is cash, not escrow. Anyone who reads it can claim it, including the sender.
  • Chat apps keep messages in cloud backups and on linked devices. An unclaimed link is exposed for as long as the chat exists.
  • Prefer the share sheet to copy and paste. Clipboard history keeps copies.
  • Don't screenshot links. Photo backups keep them.

Source: apps/web/content/docs/payment-links.md