Ship your first agent receipt on Stellar this Halloween

Watch in 60 seconds

English voiceover with captions.

Your badge in 3 steps

Everything runs on testnet. Your key, your receipt.

1. 1

   Install

   Copy

   npm i nirium @stellar/stellar-sdk@16

2. 2

   Anchor a receipt

   Audit Trail · freex402 · payneeds testnet USDCx402Serve · chargeneeds testnet USDCMore nodes →
   Copy

   import { Agent } from 'nirium';
   import { Keypair } from '@stellar/stellar-sdk';
   import { createHash } from 'node:crypto';
   
   const kp = Keypair.random(); // a new testnet key, no funds needed. Save kp.secret() to reuse it
   const sha = createHash('sha256').update('my first Niriumtober receipt').digest('hex');
   const signature = Buffer.from(kp.sign(Buffer.from(`nirium-audit-v1:${sha}`))).toString('base64');
   
   const agent = new Agent({ baseUrl: 'https://nirium-agent.fly.dev' });
   const { cid } = await agent.anchorAuditRecord({ hash: sha, tag: 'niriumtober', agent: { key: kp.publicKey(), signature } });
   console.log('CID:', cid);
   console.log('Your public key:', kp.publicKey());

   Save it as receipt.mjs and run node receipt.mjs. It prints your CID and your public key. No account and no funds needed.

   Using Claude or Cursor? Give it the Nirium skill and let it build this for you
3. 3

   Send your proof

   Open the form, paste your CID and your public key. It is public, so never paste your secret key.A repo is optional for Builder. Mainnet Builder and Champion need a public repo.

   Send your proof

That's it: you just earned Builder 🔨

Collect all 4

Packages and keys

npm i nirium @stellar/stellar-sdk@16

pip install nirium

npx nirium-mcp

mkdir -p ~/.claude/skills/nirium-agentic-payments && curl -fsSL https://raw.githubusercontent.com/nirium-protocol/nirium/main/skills/nirium-agentic-payments/SKILL.md -o ~/.claude/skills/nirium-agentic-payments/SKILL.md

npm i -g nirium-cli

npm i nirium-pollar-adapter

Prefer code? Pick an issue

How to claim an issue: comment with a plan for that specific issue, the files you will touch and how you will test it. A bare “I'll take it” or a generic template does not count. The first valid plan gets it, one active issue per person. If there is no draft PR within 48 hours of assignment, the issue goes back to the pool. A merged PR earns Contributor.

1. #168Write a short agent horror storyAvailable

   Halloween edition: a short, original horror story about an AI agent, a payment or a Stellar transaction that goes wrong. The key that signed at midnight, the receipt that was never anchored, the facilitator that answered 402 forever. Add community/horror-stories/<your-github-handle>.md. English or Spanish.

   Done when: One file, 100 to 300 words, your name or handle at the end. Fictional characters only, never a real person or project.

2. #169ASCII art: a jack-o'-lantern, the Nirium logo or a Halloween themeAvailable

   Add community/ascii/<your-github-handle>-<name>.txt with one piece: a jack-o'-lantern, the Nirium mark, a ghost, a bat, a haunted node. Plain ASCII characters only.

   Done when: One file, at most 80 columns and 40 lines, and the PR pastes what cat prints in a terminal.

3. #170Translate examples/go-x402/README.md to SpanishAvailable

   It is the shortest README under examples/. Add examples/go-x402/README.es.md and a one-line link to it at the top of the English README.

   Done when: Commands, code blocks and header names like PAYMENT-SIGNATURE are unchanged, and nothing is added that the English text does not say.

4. #171Example: anchor and verify an Audit Trail receipt from PythonAvailable

   anchor_audit_record() exists in the Python package, but examples/ has no Python example for Audit Trail. Add examples/python-audit-anchor: hash a file, anchor it on testnet, fetch the CID back and check the hash.

   Done when: README with exact commands, and the PR shows a real testnet CID produced by running it.

5. #172Tests for anchor_audit_record() in the Python packageAvailable

   packages/sdk-python/tests/ only covers the LangChain tool and the WebSocket client. Add tests for anchor_audit_record(): payload shape, hash vs record, and the error when neither is given. Mock HTTP, no network.

   Done when: pytest passes locally and the PR pastes the output.

6. #173Docs: verify an Audit Trail CID by handAvailable

   The verification model is only written up in the GitHub Action's README. Add docs/verify-audit-cid.md: fetch the document, recompute sha-256 over record, rebuild nirium-audit-v1:<sha256> and check the ed25519 signature against agent.key.

   Done when: Every step is a copy-paste command, and it is checked against a real testnet CID cited in the doc.

7. #174Docs (ES): Spanish version of the x402 quickstartAvailable

   There is no Spanish file in the repo. Translate docs/quickstart-x402.md to docs/es/quickstart-x402.md and link both ways.

   Done when: Commands and code blocks are unchanged, and you ran the quickstart on testnet while translating it (hash in the PR).

8. #175Docs (ES): Spanish README for the Python packageAvailable

   Add packages/sdk-python/README.es.md with a link at the top of the English README. Keep the known limits it states (for example, MPP Charge in Python) exactly as written.

   Done when: Same sections as the English README, nothing added that the English one does not say.

9. #176Example: x402Serve() on plain Express, testnetAvailable

   examples/express-x402 wires @x402/express by hand; only the Vercel example uses x402Serve(). Add a minimal Express server that charges for one route with x402Serve() on stellar:testnet.

   Done when: A paid request settles on testnet and the PR includes the settlement tx hash.

10. #177Python: make mpp_fetch() pay an MPP Charge server on testnetAvailable

    The Python README says init_mpp()/mpp_fetch() cannot pay an MPP Charge server today. Fix it for testnet only, matching what the TypeScript client already does.

    Done when: A real payment to the hosted testnet /api/v1/mpp/signals with its tx hash, plus a test. The README note is updated in the same PR.

11. #178Example: a Payouts run on testnetAvailable

    No example covers Payouts. Add one that builds a two-recipient run on testnet with acknowledgeTerms, signs it with a throwaway testnet key and submits it.

    Done when: Testnet tx hash in the PR. The example never asks for a mainnet key.

12. #179Example: Reporting summary and CSV exportAvailable

    get_reporting_summary() and get_reporting_export() have no example. Add a short script that prints the testnet summary and saves the export to a file.

    Done when: Runs against testnet; the PR pastes the command and the first lines of output.

13. #180examples/README.md: an index of the examplesAvailable

    examples/ has twelve folders and no index. Add examples/README.md with one line per example: what it shows, language, and network.

    Done when: Every folder is listed and every link resolves.

14. #181Research: aggregate spending caps for the pre-sign policy hookAvailable

    The pre-sign policy hook decides one payment at a time. Write a design note on spending caps per time window, per destination and per asset, built on top of it. Related: #127.

    Done when: docs/research/aggregate-spending-caps.md with at least 3 designs compared, a policy in pseudocode and the edge cases: retries, concurrent payments, a restart mid-window.

15. #182Research: a multi-asset DeFindex vault on testnet (USDC, XLM, CETES)Available

    Can one DeFindex vault on testnet hold USDC, XLM and CETES at once? Find out, with sources.

    Done when: docs/research/defindex-multi-asset-testnet.md with a table of testnet contract ids, each with a stellar.expert link or a read-only call, and a clear yes or no with what is missing.

16. #183Research: Audit Trail receipts vs W3C Verifiable Credentials and C2PAAvailable

    Compare an Audit Trail receipt (a signed hash on IPFS) with W3C Verifiable Credentials and C2PA.

    Done when: docs/research/audit-receipts-vs-vc-c2pa.md with a comparison table, one real testnet CID mapped field by field to a credential, and the gaps on each side.

17. #184Python: port the pre-sign policy hook (ALLOW, DENY, WAIT)Available

    Port the TypeScript pre-sign policy hook to the Python package: ALLOW, DENY or WAIT, with contextHash and expiresAt. Anything but a valid ALLOW signs nothing.

    Done when: pytest passes for each verdict, a wrong contextHash and an expired expiresAt, plus a testnet tx hash of a payment allowed by the policy.

18. #185verify-audit-cid: try more than one IPFS gatewayAvailable

    The Action fetches from one IPFS gateway, and today its default answers 429. Try several gateways in order and report which one answered. Related: #135.

    Done when: Tests for a downed first gateway and for a real testnet CID pass, and dist/index.js is rebuilt.

FAQ