Repository navigation
docs(es): Spanish x402 quickstart. - #231
Merged
M0nsxx merged 3 commits intoNov 3, 2026
Merged
Conversation
Add comprehensive Spanish translation (docs/es/quickstart-x402.md) of the x402 quickstart guide for LATAM builders: - Installation with npm (nirium @stellar/stellar-sdk@16) - Stellar testnet setup with funded secret key - initX402 configuration with network parameter - First paid call with x402Fetch - Troubleshooting common errors - Python/LangChain integration reference All code blocks and commands remain unchanged from the English version. Cross-linked bidirectionally: EN↔ES in both files and README. Closes nirium-protocol#174 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Co-authored-by: Edgadafi <Edgadafi@users.noreply.github.com>
Expand Spanish quickstart to match Edgar's committed plan (issue nirium-protocol#174): 1. Stellar key creation and funding (testnet + pubnet) - Friendbot for testnet XLM - USDC trustline setup with correct issuers: * Testnet: GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5 * Pubnet: GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN - Circle faucet link for testnet USDC 2. initX402 with maxAmountPerPayment spending guard - Documented as USD amount ($5, 5, or 5) - Default $1 from @x402/core - Prevents unexpected high payments before signing 3. First paid call to /api/v1/premium/market ($0.05 USDC) - Verified price and endpoint from packages/sdk/README.md - Testnet and pubnet supported (unlike /signals which is testnet-only) 4. Common errors section - x402 client not initialized - Missing STELLAR_SECRET_KEY - fetch() vs x402Fetch() - X402SpendCapError (spend cap exceeded) - Missing USDC trustline - Testnet vs mainnet confusion All code verified against: - packages/sdk/src/index.ts (maxAmountPerPayment normalization) - packages/sdk/README.md (endpoint pricing) - examples/routedock-manifest/scripts/setup-testnet-accounts.ts (USDC issuers) Env vars only, no real keys. EN/ES cross-links preserved. Closes nirium-protocol#174 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Co-authored-by: Edgadafi <Edgadafi@users.noreply.github.com>
Contributor
Author
|
Docs-only change. The failing "SDK - npm audit" check comes from a new upstream advisory in follow-redirects (GHSA-mrwp-f3q8-3g9p, transitive), unrelated to this PR. Happy to rebase once main is fixed. |
…-quickstart-cf3d Co-authored-by: Edgadafi <Edgadafi@users.noreply.github.com>
Edgadafi
changed the title
Contributor
Author
|
Updated both branches with main (follow-redirects fix included), renamed #231 and added Testing sections. CI shows "2 workflows awaiting approval" since it's a fork. Could you approve them when you get a chance? |
Edgadafi
marked this pull request as ready for review
November 2, 2026 20:21
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Part of Niriumtober.
Spanish x402 quickstart (docs/es/quickstart-x402.md) for LATAM builders, following the plan in #174:
EN/ES docs are cross-linked. No real keys; env vars only.
Testing
Ran the guide on Stellar testnet with a throwaway key
GDFPSM6WFCRSY4JH7G2GKGKJRVKVY7AOJ5KYSJ6TOCFLYEHXP6VPZT2X.initX402({ network: "stellar:testnet", maxAmountPerPayment: "$1" })initialized without errors.x402Fetchto/api/v1/premium/market: not run yet. Testnet USDC requires the Circle faucet (captcha); will add the paid-call tx hash once funded.AI disclosure
Drafted with AI assistance (Cursor agent). I verified option names, prices, issuers and error types against the codebase.
Closes #174