@ramp-kit/mcp 0.1.1 → 0.1.2

package/dist/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,MAAM,uGAOT,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CA2LtC,CAAC"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,MAAM,uGAOT,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAkNtC,CAAC"}

package/dist/docs.js

@@ -64,7 +64,8 @@ const provider = new EtherfuseProvider({ apiKey, environment: "sandbox" });
 const org = await provider.getOrganization();          // customerId
 const accounts = await provider.listBankAccounts();     // pick compliant one
 provider.setBankAccount(accounts.find(a => a.compliant)!.bankAccountId);
-await provider.registerWallet(walletAddress, "stellar"); // one-time, required
+// Wallet registration is automatic since 0.1.3: createOrder self-heals
+// "Wallet not found" by registering (idempotent) and retrying once.
 
 const assets = await provider.listAssets("stellar", { currency: "brl" });
 const quote = await provider.getQuote({ direction: "onramp",
@@ -76,16 +77,36 @@ await provider.simulateFiatReceived(order.id);          // sandbox only
 // poll provider.getOrder(order.id) until "settled"
 \`\`\`
 
+## Offramp (crypto → fiat, "BRL out")
+\`\`\`ts
+const quote = await provider.getQuote({ direction: 'offramp',
+  fiatCurrency: 'BRL', assetIdentifier: usdc.identifier,
+  network: 'stellar', sourceAmount: '5',
+  customerId: org.id, walletAddress });
+const order = await provider.createOrder(quote);
+// order.unsignedTx appears async → status awaiting_signature; sign it:
+await signAndSubmit(order.unsignedTx, walletSigner, stellarConfigFor('sandbox'));
+// tx_too_late → provider.regenerateTx(order.id) and retry
+\`\`\`
+
 ## React widget
 \`\`\`tsx
 import { RampWidget } from "@ramp-kit/react";
+// Buy flow:
 <RampWidget provider={provider} customerId={org.id} fiatCurrency="BRL"
   network="stellar" walletAddress={wallet} assets={assets} />
+// Sell flow adds: direction="offramp", signer={walletSignCallback},
+// stellarConfig={stellarConfigFor(env)} — includes in-widget Sign & send
+// with automatic tx regeneration, and Stellar Expert proof links.
 \`\`\`
 
+Wallet UX pattern (see apps/demo): connect the user's wallet via Freighter
+(@stellar/freighter-api) — request access, verify network matches, sign via
+extension. Never collect secret keys in app UIs.
+
 Key rules: quotes expire (Etherfuse: 2 min) — check \`expiresAt\`; never
-hardcode asset identifiers — always discover via listAssets(); wallets must
-be registered before their first order.`,
+hardcode asset identifiers — always discover via listAssets(); wallet
+registration is automatic on first order (self-heal + retry in the SDK).`,
     "sandbox-setup": `# Etherfuse sandbox setup (one time, ~10 minutes)
 
 1. Create an account at https://sandbox.etherfuse.com
@@ -171,8 +192,10 @@ new EtherfuseProvider({ apiKey: "", baseUrl: "https://api.myapp.com/etherfuse" }
     troubleshooting: `# Troubleshooting (verified against the real sandbox)
 
 - "Wallet not found or not authorized" on POST /ramp/order → the wallet was
-  never registered. Call provider.registerWallet(publicKey, "stellar")
-  (claimOwnership=true lets a KYB-approved org skip per-wallet KYC).
+  never registered. @ramp-kit/core ≥0.1.3 self-heals this automatically
+  (registers + retries once); on older versions or raw HTTP, call
+  provider.registerWallet(publicKey, "stellar") (claimOwnership=true lets a
+  KYB-approved org skip per-wallet KYC).
 - "Bank account is not compliant with KYC requirements" → the selected bank
   account's compliant flag is false. MXN accounts registered via API await
   async approval; dashboard-created BRL/PIX accounts are compliant

package/dist/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU;IACV,YAAY;IACZ,eAAe;IACf,cAAc;IACd,YAAY;IACZ,iBAAiB;CACT,CAAC;AAIX,MAAM,CAAC,MAAM,IAAI,GAA0B;IACzC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDA4BoC;IAE9C,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA6C0B;IAEtC,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;qCAuBkB;IAEnC,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDA4ByC;IAEvD,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;kFA4BoE;IAEhF,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;yEAuBsD;CACxE,CAAC"}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU;IACV,YAAY;IACZ,eAAe;IACf,cAAc;IACd,YAAY;IACZ,iBAAiB;CACT,CAAC;AAIX,MAAM,CAAC,MAAM,IAAI,GAA0B;IACzC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDA4BoC;IAE9C,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yEAkE2D;IAEvE,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;qCAuBkB;IAEnC,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDA4ByC;IAEvD,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;kFA4BoE;IAEhF,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;yEAyBsD;CACxE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramp-kit/mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP server for the LATAM Ramp Kit: lets AI agents explore providers, fetch live ramp quotes, create sandbox orders, simulate PIX/SPEI deposits and inspect Stellar wallets — plus built-in documentation tools covering usage, architecture and the path to production",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,7 +16,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.23.0",
-    "@ramp-kit/core": "0.1.2"
+    "@ramp-kit/core": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",