{"_id":"@ackrate/stellar","_rev":"5-c774d69a239b3d2d0a2954bb203f8aac","name":"@ackrate/stellar","dist-tags":{"latest":"0.3.0"},"versions":{"0.2.2":{"name":"@ackrate/stellar","version":"0.2.2","keywords":["stellar","soroban","ackrate","mandate","agent-payments","x402","ap2","sep-41","micropayments","ai-agents"],"license":"Apache-2.0","_id":"@ackrate/stellar@0.2.2","maintainers":[{"name":"ackrate","email":"drewgonzales2021@gmail.com"}],"homepage":"https://github.com/reapp-protocol/ackrate-research-arena#readme","bugs":{"url":"https://github.com/reapp-protocol/ackrate-research-arena/issues"},"dist":{"shasum":"68be56663d7c6e25f2eccac44e2e23af26fc1a61","tarball":"https://registry.npmjs.org/@ackrate/stellar/-/stellar-0.2.2.tgz","fileCount":16,"integrity":"sha512-z9Gjkolo6JXB+L4KDEv6slfj0lN5AT3zKKSekWVX3AKXVPOqiEOvnNDbM16CnPCb+lZfxJyvlc4lLGSqmKh+QA==","signatures":[{"sig":"MEYCIQCKIpCbZS7x+I3zdxiG8Yaf159cWmruaiTr4W7PpC39LAIhAMAt78E+aAVWaC5gU0zf0utdBsQ6Z76Pfq4rGA0ZPm2g","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32301},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"dd5e43133a11e178e220640a73defa9e8d96a048","scripts":{"test":"node --import tsx --test src/deployments.test.ts","build":"tsc"},"_npmUser":{"name":"ackrate","email":"drewgonzales2021@gmail.com"},"repository":{"url":"git+https://github.com/reapp-protocol/ackrate-research-arena.git","type":"git","directory":"packages/stellar"},"_npmVersion":"11.16.0","description":"Stellar Soroban bindings, network configuration, and signing helpers for ackrate agent payments.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"buffer":"6.0.3","@types/urijs":"^1.19.26","@types/json-schema":"^7.0.15","@stellar/stellar-sdk":"^14.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2"},"_npmOperationalInternal":{"tmp":"tmp/stellar_0.2.2_1785558062547_0.7694918877241232","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@ackrate/stellar","version":"0.2.3","keywords":["stellar","soroban","ackrate","mandate","agent-payments","x402","ap2","sep-41","micropayments","ai-agents"],"license":"Apache-2.0","_id":"@ackrate/stellar@0.2.3","maintainers":[{"name":"ackrate","email":"drewgonzales2021@gmail.com"}],"homepage":"https://github.com/reapp-protocol/ackrate-research-arena#readme","bugs":{"url":"https://github.com/reapp-protocol/ackrate-research-arena/issues"},"dist":{"shasum":"21e26eba4b0d6c5221dcd743f4292f707796b2b8","tarball":"https://registry.npmjs.org/@ackrate/stellar/-/stellar-0.2.3.tgz","fileCount":16,"integrity":"sha512-GNJph8007feboxRhW+IaTFQarBH6hTUsMzTZ168ZxM1Ei4HFMh34UbWhZF6aUus4LIGGp+Le2drdx28vTmsmtA==","signatures":[{"sig":"MEUCIQDk1vwVRid4NqQc9b+HL/ssZ4W650GK6EGWgFUHyNCSMwIgKmgDJSIpn2PGuHUmi472wLOywtX2kaw1NtLD7cbgtwM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36087},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"0e0d1a2c01c73310ab4aa47ff2c84b1e0dc46e8d","_npmUser":{"name":"ackrate","email":"drewgonzales2021@gmail.com"},"repository":{"url":"git+https://github.com/reapp-protocol/ackrate-research-arena.git","type":"git","directory":"packages/stellar"},"_npmVersion":"11.16.0","description":"Typed MandateRegistry bindings, Stellar testnet configuration, and signing helpers for ackrate agent payments.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"buffer":"6.0.3","@types/urijs":"^1.19.26","@types/json-schema":"^7.0.15","@stellar/stellar-sdk":"^14.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/stellar_0.2.3_1785641031006_0.603109930296672","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@ackrate/stellar","version":"0.2.4","keywords":["stellar","soroban","ackrate","mandate","agent-payments","x402","ap2","sep-41","micropayments","ai-agents"],"license":"Apache-2.0","_id":"@ackrate/stellar@0.2.4","maintainers":[{"name":"ackrate","email":"drewgonzales2021@gmail.com"}],"homepage":"https://github.com/ackrate/ackrate-protocol/tree/main/packages/stellar#readme","bugs":{"url":"https://github.com/ackrate/ackrate-protocol/issues"},"dist":{"shasum":"e97267a7236bdf0b7067d0142a2ad9550314034c","tarball":"https://registry.npmjs.org/@ackrate/stellar/-/stellar-0.2.4.tgz","fileCount":24,"integrity":"sha512-z4duXD9LviMSDGFWSh18Eg6QXmf9U5//91BSQ8rMMdurrcZTINvzseOevgqw1QVGVcvpFM+JGYEu7f9nBE7FjQ==","signatures":[{"sig":"MEUCIAQf+ys7pFInW6N26poSk2HjmcRrocTxv+U1YNnD0oSZAiEAt6Ha6qK0K64YU62+hKOX9N/aQxvaSgOTR64beEGxenw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61219},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"76dcd1ed93729dc54a87a253dc272ee4915addef","scripts":{"test":"node --import tsx --test src/deployments.test.ts src/release-manifest.test.ts src/signer.test.ts","build":"tsc"},"_npmUser":{"name":"ackrate","email":"drewgonzales2021@gmail.com"},"repository":{"url":"git+https://github.com/ackrate/ackrate-protocol.git","type":"git","directory":"packages/stellar"},"_npmVersion":"11.16.0","description":"Soroban client + typed MandateRegistry bindings, network config, and signing helpers for Ackrate.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"buffer":"6.0.3","@types/urijs":"^1.19.26","@types/json-schema":"^7.0.15","@stellar/stellar-sdk":"^14.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2"},"_npmOperationalInternal":{"tmp":"tmp/stellar_0.2.4_1787742804419_0.6176973290102423","host":"s3://npm-registry-packages-npm-production"}},"0.2.5":{"name":"@ackrate/stellar","version":"0.2.5","keywords":["stellar","soroban","ackrate","mandate","agent-payments","x402","ap2","sep-41","micropayments","ai-agents"],"license":"Apache-2.0","_id":"@ackrate/stellar@0.2.5","maintainers":[{"name":"ackrate","email":"drewgonzales2021@gmail.com"}],"homepage":"https://github.com/ackrate/ackrate-protocol/tree/main/packages/stellar#readme","bugs":{"url":"https://github.com/ackrate/ackrate-protocol/issues"},"dist":{"shasum":"0e1afc274581aef262aee0d2a4292a6571c50ec1","tarball":"https://registry.npmjs.org/@ackrate/stellar/-/stellar-0.2.5.tgz","fileCount":20,"integrity":"sha512-PYTP0K4fu6NgXR2knqaJH3cPvVMF7oqkG4OmQ4obQFhbkpI6HT9xN3x878Jx7kVM0VoZ1d1FDIPUjtMK03js6w==","signatures":[{"sig":"MEQCIGGbg0yS0e+FheUoiHKfWKBgYdPTJkSD1JXD3dRruzzuAiBcUPV+pN90lcJo6E+S1bnr3vFlYtOr9IGA1pbGX/qc4w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQD4/cdLTiWXZhTXKmQmux7SYptv1Tw14Cel8l7kv+uizgIhAM++tXzjaC5Y+GW72TUT6ywpBmNN6jsSXXPd5bvBokop","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":82409},"main":"./dist/index.js","type":"module","_from":"file:/var/folders/t0/nkfkv7xj1bx7njmf7_mb7nhh0000gn/T/ackrate-verified-candidates-oZ1dCG/ackrate-stellar-0.2.5.tgz","types":"./dist/index.d.ts","engines":{"node":">=22.0.0"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"scripts":{"test":"node --import tsx --test src/deployments.test.ts src/release-manifest.test.ts src/signer.test.ts src/token-authorization.test.ts","build":"tsc && node ../../scripts/copy-stellar-type-compat.mjs"},"_npmUser":{"name":"ackrate","email":"drewgonzales2021@gmail.com"},"_resolved":"/var/folders/t0/nkfkv7xj1bx7njmf7_mb7nhh0000gn/T/ackrate-verified-candidates-oZ1dCG/ackrate-stellar-0.2.5.tgz","_integrity":"sha512-PYTP0K4fu6NgXR2knqaJH3cPvVMF7oqkG4OmQ4obQFhbkpI6HT9xN3x878Jx7kVM0VoZ1d1FDIPUjtMK03js6w==","repository":{"url":"git+https://github.com/ackrate/ackrate-protocol.git","type":"git","directory":"packages/stellar"},"_npmVersion":"11.16.0","description":"Soroban client + typed MandateRegistry bindings, network config, and signing helpers for Ackrate.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"buffer":"6.0.3","@types/urijs":"^1.19.26","@types/json-schema":"^7.0.15","@stellar/stellar-sdk":"16.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2"},"_npmOperationalInternal":{"tmp":"tmp/stellar_0.2.5_1788726358671_0.9881386576249138","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"_id":"@ackrate/stellar@0.3.0","bugs":{"url":"https://github.com/ackrate/ackrate-protocol/issues"},"dist":{"shasum":"395daa93da33695715a49d82e4bd45bd34f53697","tarball":"https://registry.npmjs.org/@ackrate/stellar/-/stellar-0.3.0.tgz","fileCount":22,"integrity":"sha512-XX8WFnwiNT/kBKRZ3e69CyM5HG7bL+BOyZOrBhg3mb491hJNBalpk4qBr28jU1DjGin2P4Wym+fDZlpsKB+FzQ==","signatures":[{"sig":"MEUCIQCxLujGWMn2K3Ha/4uWbte/CmMc7fcBHTCgLV2/ql/EvAIgDdSr6DVu0Dt1A7s1OIOmHVkW+7XTAqIObuUJBcXvmGg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICkYowMDKOR8MxOpzgRZHusCW5ig51B/JGL5lFLq/arIAiEAlCvym7y1GdqwwASaBmJyYPR/o+T9yVUQTmi59BbAY68="}],"unpackedSize":114542},"main":"./dist/index.js","name":"@ackrate/stellar","type":"module","_from":"file:/var/folders/t0/nkfkv7xj1bx7njmf7_mb7nhh0000gn/T/ackrate-verified-candidates-oWZbx4/ackrate-stellar-0.3.0.tgz","types":"./dist/index.d.ts","engines":{"node":">=22.0.0"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"license":"Apache-2.0","scripts":{"test":"node --import tsx --test src/deployments.test.ts src/release-manifest.test.ts src/signer.test.ts src/token-authorization.test.ts","build":"tsc && node ../../scripts/copy-stellar-type-compat.mjs"},"version":"0.3.0","_npmUser":{"name":"ackrate","email":"drewgonzales2021@gmail.com"},"homepage":"https://github.com/ackrate/ackrate-protocol/tree/main/packages/stellar#readme","keywords":["stellar","soroban","ackrate","mandate","agent-payments","x402","ap2","sep-41","micropayments","ai-agents"],"_resolved":"/var/folders/t0/nkfkv7xj1bx7njmf7_mb7nhh0000gn/T/ackrate-verified-candidates-oWZbx4/ackrate-stellar-0.3.0.tgz","_integrity":"sha512-XX8WFnwiNT/kBKRZ3e69CyM5HG7bL+BOyZOrBhg3mb491hJNBalpk4qBr28jU1DjGin2P4Wym+fDZlpsKB+FzQ==","repository":{"url":"git+https://github.com/ackrate/ackrate-protocol.git","type":"git","directory":"packages/stellar"},"_npmVersion":"11.16.0","description":"Stellar Mainnet configuration, Soroban mandate client, and signing helpers for the official ACKRATE MandateRegistry.","directories":{},"maintainers":[{"name":"ackrate","email":"drewgonzales2021@gmail.com"}],"_nodeVersion":"26.3.0","dependencies":{"buffer":"6.0.3","@types/urijs":"^1.19.26","@types/json-schema":"^7.0.15","@stellar/stellar-sdk":"16.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/stellar_0.3.0_1788729573765_0.9188574269802883"}}},"time":{"created":"2026-08-01T04:21:02.304Z","modified":"2026-09-06T21:19:34.027Z","0.2.2":"2026-08-01T04:21:02.712Z","0.2.3":"2026-08-02T03:23:51.144Z","0.2.4":"2026-08-26T11:13:24.568Z","0.2.5":"2026-09-06T20:25:58.749Z","0.3.0":"2026-09-06T21:19:33.862Z"},"bugs":{"url":"https://github.com/ackrate/ackrate-protocol/issues"},"license":"Apache-2.0","homepage":"https://github.com/ackrate/ackrate-protocol/tree/main/packages/stellar#readme","keywords":["stellar","soroban","ackrate","mandate","agent-payments","x402","ap2","sep-41","micropayments","ai-agents"],"repository":{"url":"git+https://github.com/ackrate/ackrate-protocol.git","type":"git","directory":"packages/stellar"},"description":"Stellar Mainnet configuration, Soroban mandate client, and signing helpers for the official ACKRATE MandateRegistry.","maintainers":[{"name":"ackrate","email":"drewgonzales2021@gmail.com"}],"readme":"# @ackrate/stellar 0.3.0\n\nThe Stellar Mainnet configuration, contract client, wallet-signing interface,\nand USDC helpers for Ackrate.\n\nMainnet MandateRegistry:\n[`CCLZEBJXG4YVJEPBCR5F27N733BCK5HQJWZZGB3K54JVODY3VAGP4HWR`](https://stellar.expert/explorer/public/contract/CCLZEBJXG4YVJEPBCR5F27N733BCK5HQJWZZGB3K54JVODY3VAGP4HWR).\n\nThis is the stable contract address used by the coordinated Ackrate packages.\nAuthorized same-address upgrades replace its implementation, not its address.\nImplementation changes still require compatibility checks and updated release\nevidence. The contract, not this package, enforces each payment.\n\n## Install\n\n```bash\nnpm install --save-exact @ackrate/stellar@0.3.0 @stellar/stellar-sdk@16.3.0\n```\n\nRequires Node.js 22 or newer. See the\n[coordinated release status](https://github.com/ackrate/ackrate-protocol/blob/main/docs/ackrate-sdk-npm.md)\nfor publication and clean-install verification. Most applications should start\nwith [`@ackrate/core`](https://www.npmjs.com/package/@ackrate/core).\n\n## Mainnet configuration\n\n`MAINNET` provides the official registry address, public-network passphrase,\nRPC configuration, canonical Circle USDC identity, and validated deployment\nmetadata. You do not need to copy the contract ID into application code.\n\n```ts\nimport { MAINNET, MAINNET_DEPLOYMENT_MANIFEST } from \"@ackrate/stellar\";\n\nconsole.log(MAINNET.mandateRegistryId);\nconsole.log(MAINNET.settlementAsset.contractId); // Canonical Stellar USDC.\nconsole.log(MAINNET_DEPLOYMENT_MANIFEST);        // Public deployment evidence.\n```\n\nThe [canonical configuration source](https://github.com/ackrate/ackrate-protocol/blob/main/packages/stellar/src/deployments.ts)\nrecords registry version `0.4.1`, schema `2`, source revision\n`02d43f5358aa567447447e44407546b6c7de1683`, and original deployment WASM SHA-256\n`982809197d35d44c7b0fce6bd117fb2fec09b728c64c146c1f803b01faacff62`.\nThe [Mainnet deployment record](https://github.com/ackrate/ackrate-protocol-contracts/blob/main/contracts/mainnet-v2/README.md)\nlinks the deployment transactions, contract source, and release artifact.\n\nConfiguration is not a live-chain check or permission to spend. Before a\nreal-USDC operation, verify the selected deployment, asset, current contract\nstate, signer accounts, balances, and intended budget. XLM pays transaction fees.\n\n## Read a balance\n\n```ts\nimport { MAINNET, token } from \"@ackrate/stellar\";\n\nconst balance = await token.balance(\n  MAINNET,\n  MAINNET.settlementAsset.contractId,\n  walletAddress,\n);\nconsole.log(balance); // Integer amount; Stellar USDC has 7 decimal places.\n```\n\n`walletAddress` is the public address supplied by your connected wallet. This\nread simulates a contract call; it does not sign or submit a transaction.\n\n## Contract and wallet APIs\n\n| Export | Purpose |\n|---|---|\n| `MAINNET` | Ready-to-use official Mainnet network configuration. |\n| `MAINNET_DEPLOYMENT_MANIFEST` | Complete bundled public deployment record. |\n| `DEPLOYMENTS.mainnet` | Registry identity, artifact fingerprints, and evidence links. |\n| `publishedMainnetNetworkFromDeploymentManifest(manifest)` | Validate a complete supplied manifest against the pinned official deployment identity. |\n| `registryClient(network, signer)` | Create a typed contract client using an explicit network and wallet signer. |\n| `StellarSigner` | External signing interface; user-controlled keys stay outside the application. |\n| `stellarSigner(input, passphrase)` | Normalize an external signer or managed key into that interface. |\n| `keypairSigner(keypair, passphrase)` | Adapt a securely managed Stellar keypair. |\n| `token.balance`, `token.authorized`, `token.decimals` | Read token balance, account authorization, and decimals. |\n| `token.approve` | User-signed SEP-41 allowance; the spender must be the registry, never the agent. |\n\nThe payment interface supports `register_mandate`, `get_mandate`,\n`validate_mandate`, `execute_payment`, and `revoke_mandate`. An agent payment\nmust call `execute_payment`; a read-only validation cannot replace settlement.\nThe contract revalidates and consumes the mandate atomically with its transfer.\n\n`StellarSigner` requires the wallet public key and `signTransaction`; it can\nalso provide `signAuthEntry` and detached `signPayload`. Paid x402 requests need\ndetached agent signing to bind the exact HTTP challenge to the settlement proof.\nA transaction-only signer can make direct payments but cannot produce that\nproof. Keep secrets in a wallet or secret manager, never source code or logs.\n\nFor user setup and crash-safe payments, use the\n[Core workflow](https://github.com/ackrate/ackrate-protocol/blob/main/packages/sdk/README.md).\nFor governed operations, use the\n[Mainnet contract guide](https://github.com/ackrate/ackrate-protocol-contracts/blob/main/contracts/mainnet-v2/README.md)\nand the CLI's two-signature coordination commands.\n\nApache-2.0.\n","readmeFilename":"README.md"}