envoy-pay 0.1.0

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/esm/contracts/abis/EnvoyFacilitator.js

@@ -0,0 +1,194 @@
+/**
+ * Minimal ABI for `EnvoyFacilitator.sol`. Hand-curated to expose only the
+ * functions and events the SDK touches — keep it lean so callers' bundles
+ * don't carry hardhat/typechain output.
+ *
+ * Marked `as const` so viem can infer types end-to-end.
+ */
+export const ENVOY_FACILITATOR_ABI = [
+    // ---- writes ----
+    {
+        type: 'function',
+        name: 'pay',
+        stateMutability: 'nonpayable',
+        inputs: [
+            {
+                name: 'auth',
+                type: 'tuple',
+                components: [
+                    { name: 'agentId', type: 'uint256' },
+                    { name: 'token', type: 'address' },
+                    { name: 'merchant', type: 'address' },
+                    { name: 'amount', type: 'uint256' },
+                    { name: 'challengeId', type: 'bytes32' },
+                    { name: 'nonce', type: 'uint256' },
+                    { name: 'deadline', type: 'uint64' },
+                ],
+            },
+            { name: 'signature', type: 'bytes' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'setLimit',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'token', type: 'address' },
+            { name: 'perTx', type: 'uint128' },
+            { name: 'perPeriod', type: 'uint128' },
+            { name: 'periodLen', type: 'uint32' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'disableLimit',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'token', type: 'address' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'setTreasury',
+        stateMutability: 'nonpayable',
+        inputs: [{ name: 'newTreasury', type: 'address' }],
+        outputs: [],
+    },
+    // ---- reads ----
+    {
+        type: 'function',
+        name: 'IDENTITY',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'address' }],
+    },
+    {
+        type: 'function',
+        name: 'feeBps',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint16' }],
+    },
+    {
+        type: 'function',
+        name: 'MAX_FEE_BPS',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint16' }],
+    },
+    {
+        type: 'function',
+        name: 'treasury',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'address' }],
+    },
+    {
+        type: 'function',
+        name: 'getLimit',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'token', type: 'address' },
+        ],
+        outputs: [
+            {
+                type: 'tuple',
+                components: [
+                    { name: 'perTx', type: 'uint128' },
+                    { name: 'perPeriod', type: 'uint128' },
+                    { name: 'spentInPeriod', type: 'uint128' },
+                    { name: 'periodStart', type: 'uint64' },
+                    { name: 'periodLen', type: 'uint32' },
+                    { name: 'enabled', type: 'bool' },
+                ],
+            },
+        ],
+    },
+    {
+        type: 'function',
+        name: 'isNonceUsed',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'nonce', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    {
+        type: 'function',
+        name: 'paymentAuthHash',
+        stateMutability: 'view',
+        inputs: [
+            {
+                name: 'auth',
+                type: 'tuple',
+                components: [
+                    { name: 'agentId', type: 'uint256' },
+                    { name: 'token', type: 'address' },
+                    { name: 'merchant', type: 'address' },
+                    { name: 'amount', type: 'uint256' },
+                    { name: 'challengeId', type: 'bytes32' },
+                    { name: 'nonce', type: 'uint256' },
+                    { name: 'deadline', type: 'uint64' },
+                ],
+            },
+        ],
+        outputs: [{ name: '', type: 'bytes32' }],
+    },
+    {
+        type: 'function',
+        name: 'domainSeparator',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'bytes32' }],
+    },
+    // ---- events ----
+    {
+        type: 'event',
+        name: 'Settled',
+        inputs: [
+            { name: 'challengeId', type: 'bytes32', indexed: true },
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'merchant', type: 'address', indexed: true },
+            { name: 'token', type: 'address', indexed: false },
+            { name: 'amount', type: 'uint256', indexed: false },
+            { name: 'fee', type: 'uint256', indexed: false },
+            { name: 'nonce', type: 'uint256', indexed: false },
+            { name: 'signer', type: 'address', indexed: false },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'LimitSet',
+        inputs: [
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'token', type: 'address', indexed: true },
+            { name: 'perTx', type: 'uint128', indexed: false },
+            { name: 'perPeriod', type: 'uint128', indexed: false },
+            { name: 'periodLen', type: 'uint32', indexed: false },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'LimitDisabled',
+        inputs: [
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'token', type: 'address', indexed: true },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'TreasurySet',
+        inputs: [
+            { name: 'previous', type: 'address', indexed: true },
+            { name: 'current', type: 'address', indexed: true },
+        ],
+    },
+];
+//# sourceMappingURL=EnvoyFacilitator.js.map

package/dist/esm/contracts/abis/EnvoyFacilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvoyFacilitator.js","sourceRoot":"","sources":["../../../../src/contracts/abis/EnvoyFacilitator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,mBAAmB;IACnB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,KAAK;QACX,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;oBACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;oBAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;oBACnC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;oBACxC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;oBAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACrC;aACF;YACD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE;SACrC;QACD,OAAO,EAAE,EAAE;KACZ;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;SACtC;QACD,OAAO,EAAE,EAAE;KACZ;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,cAAc;QACpB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;SACnC;QACD,OAAO,EAAE,EAAE;KACZ;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,aAAa;QACnB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAClD,OAAO,EAAE,EAAE;KACZ;IACD,kBAAkB;IAClB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,QAAQ;QACd,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;KACxC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,aAAa;QACnB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;KACxC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;SACnC;QACD,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;oBAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;oBACtC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC1C,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACvC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACrC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;iBAClC;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,aAAa;QACnB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;SACnC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KACtC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,iBAAiB;QACvB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;oBACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;oBAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;oBACnC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;oBACxC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;oBAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACrC;aACF;SACF;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,iBAAiB;QACvB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC;IACD,mBAAmB;IACnB;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,SAAS;QACf,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACvD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACnD,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACpD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YAClD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACnD,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YAChD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YAClD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;SACpD;KACF;IACD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACnD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACjD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YAClD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACtD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;SACtD;KACF;IACD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACnD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;SAClD;KACF;IACD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACpD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;SACpD;KACF;CACO,CAAC"}

package/dist/esm/contracts/addresses.js

@@ -0,0 +1,38 @@
+/**
+ * Contract addresses for envoy's on-chain layer plus the canonical ERC-8004 registries
+ * on Celo. Keyed by EIP-155 chainId.
+ *
+ *  - `facilitator`         → `EnvoyFacilitator.sol` (this repo) — placeholder until deployed
+ *  - `identityRegistry`    → canonical ERC-8004 Identity Registry on Celo
+ *  - `reputationRegistry`  → canonical ERC-8004 Reputation Registry on Celo
+ *
+ * Run `npm run deploy:celoSepolia` in the contracts/ workspace, then paste the
+ * printed JSON to fill in the `facilitator` entries.
+ */
+const ZERO = '0x0000000000000000000000000000000000000000';
+/** Celo Mainnet (42220) */
+export const CELO_MAINNET = 42220;
+/** Celo Sepolia (11142220) — active testnet; replaces Alfajores */
+export const CELO_SEPOLIA = 11142220;
+export const ENVOY_CONTRACT_ADDRESSES = {
+    [CELO_MAINNET]: {
+        facilitator: '0xE268B6fE16319b49D22562C93c0d2395F65FCAcC',
+        identityRegistry: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432',
+        reputationRegistry: '0x8004BAa17C55a88189AE136b182e5fdA19dE9b63',
+    },
+    [CELO_SEPOLIA]: {
+        facilitator: ZERO,
+        identityRegistry: '0x8004A818BFB912233c491871b3d84c89A494BD9e',
+        reputationRegistry: '0x8004B663056A597Dffe9eCcC1965A193B7388713',
+    },
+};
+/** Lookup helper. Throws if the chain has no envoy mapping. */
+export function getEnvoyAddresses(chainId) {
+    const addresses = ENVOY_CONTRACT_ADDRESSES[chainId];
+    if (!addresses) {
+        throw new Error(`envoy is not configured for chainId ${chainId}. ` +
+            `Supported: ${Object.keys(ENVOY_CONTRACT_ADDRESSES).join(', ')}`);
+    }
+    return addresses;
+}
+//# sourceMappingURL=addresses.js.map

package/dist/esm/contracts/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../../src/contracts/addresses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,MAAM,IAAI,GAAG,4CAAqD,CAAC;AAEnE,2BAA2B;AAC3B,MAAM,CAAC,MAAM,YAAY,GAAG,KAAc,CAAC;AAC3C,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,QAAiB,CAAC;AAE9C,MAAM,CAAC,MAAM,wBAAwB,GAA2C;IAC9E,CAAC,YAAY,CAAC,EAAE;QACd,WAAW,EAAE,4CAA4C;QACzD,gBAAgB,EAAE,4CAA4C;QAC9D,kBAAkB,EAAE,4CAA4C;KACjE;IACD,CAAC,YAAY,CAAC,EAAE;QACd,WAAW,EAAE,IAAI;QACjB,gBAAgB,EAAE,4CAA4C;QAC9D,kBAAkB,EAAE,4CAA4C;KACjE;CACF,CAAC;AAEF,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,SAAS,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uCAAuC,OAAO,IAAI;YAChD,cAAc,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/esm/contracts/facilitator.js

@@ -0,0 +1,218 @@
+/**
+ * Typed viem client for `EnvoyFacilitator.sol`.
+ *
+ * Provides three layers:
+ *
+ *   1. Pure helpers — `paymentAuthDomain`, `paymentAuthTypes`, the typed-data
+ *      builder. Useful for any code that just needs to sign a `PaymentAuth`
+ *      without taking a Facilitator client dependency.
+ *   2. `signPaymentAuth(...)` — convenience wrapper around
+ *      `walletClient.signTypedData(...)` for the agent's signing wallet.
+ *   3. `createEnvoyFacilitator(...)` — full client bundling reads + writes +
+ *      sign + the contract address.
+ *
+ * All amounts are bigints in the token's smallest unit. cKES is 18 decimals;
+ * USDC is 6.
+ */
+import { decodeEventLog, getAddress, } from 'viem';
+import { ENVOY_FACILITATOR_ABI } from './abis/EnvoyFacilitator.js';
+// ---------------------------------------------------------------------------
+// EIP-712 — domain + types + builder
+// ---------------------------------------------------------------------------
+export function paymentAuthDomain(args) {
+    return {
+        name: 'EnvoyFacilitator',
+        version: '1',
+        chainId: args.chainId,
+        verifyingContract: args.facilitatorAddress,
+    };
+}
+export const PAYMENT_AUTH_TYPES = {
+    PaymentAuth: [
+        { name: 'agentId', type: 'uint256' },
+        { name: 'token', type: 'address' },
+        { name: 'merchant', type: 'address' },
+        { name: 'amount', type: 'uint256' },
+        { name: 'challengeId', type: 'bytes32' },
+        { name: 'nonce', type: 'uint256' },
+        { name: 'deadline', type: 'uint64' },
+    ],
+};
+/** Build a viem-compatible typed-data payload for `walletClient.signTypedData`. */
+export function paymentAuthTypedData(args) {
+    return {
+        domain: paymentAuthDomain(args),
+        types: PAYMENT_AUTH_TYPES,
+        primaryType: 'PaymentAuth',
+        message: args.auth,
+    };
+}
+/** Sign a `PaymentAuth` with the agent's signing wallet. */
+export async function signPaymentAuth(walletClient, args) {
+    const account = walletClient.account;
+    if (!account)
+        throw new Error('signPaymentAuth: walletClient has no account configured');
+    return walletClient.signTypedData({
+        account,
+        ...paymentAuthTypedData(args),
+    });
+}
+export function createEnvoyFacilitator(opts) {
+    const { address, publicClient, walletClient } = opts;
+    const chainId = opts.chainId ?? publicClient.chain?.id;
+    if (chainId === undefined) {
+        throw new Error('createEnvoyFacilitator: chainId could not be inferred — pass it explicitly');
+    }
+    const requireWallet = () => {
+        if (!walletClient) {
+            throw new Error('createEnvoyFacilitator: this operation needs a walletClient');
+        }
+        return walletClient;
+    };
+    const resolveAccount = (override) => {
+        if (override)
+            return override;
+        const account = walletClient?.account;
+        if (!account) {
+            throw new Error('createEnvoyFacilitator: no account on walletClient and none provided');
+        }
+        return account;
+    };
+    return {
+        address,
+        chainId,
+        // ---- reads ----
+        getFeeBps: () => publicClient.readContract({
+            address,
+            abi: ENVOY_FACILITATOR_ABI,
+            functionName: 'feeBps',
+        }),
+        getMaxFeeBps: () => publicClient.readContract({
+            address,
+            abi: ENVOY_FACILITATOR_ABI,
+            functionName: 'MAX_FEE_BPS',
+        }),
+        getTreasury: () => publicClient.readContract({
+            address,
+            abi: ENVOY_FACILITATOR_ABI,
+            functionName: 'treasury',
+        }),
+        getIdentityRegistry: () => publicClient.readContract({
+            address,
+            abi: ENVOY_FACILITATOR_ABI,
+            functionName: 'IDENTITY',
+        }),
+        getLimit: async (agentId, token) => {
+            const raw = await publicClient.readContract({
+                address,
+                abi: ENVOY_FACILITATOR_ABI,
+                functionName: 'getLimit',
+                args: [agentId, token],
+            });
+            return {
+                perTx: raw.perTx,
+                perPeriod: raw.perPeriod,
+                spentInPeriod: raw.spentInPeriod,
+                periodStart: raw.periodStart,
+                periodLen: raw.periodLen,
+                enabled: raw.enabled,
+            };
+        },
+        isNonceUsed: (agentId, nonce) => publicClient.readContract({
+            address,
+            abi: ENVOY_FACILITATOR_ABI,
+            functionName: 'isNonceUsed',
+            args: [agentId, nonce],
+        }),
+        paymentAuthHash: (auth) => publicClient.readContract({
+            address,
+            abi: ENVOY_FACILITATOR_ABI,
+            functionName: 'paymentAuthHash',
+            args: [auth],
+        }),
+        domainSeparator: () => publicClient.readContract({
+            address,
+            abi: ENVOY_FACILITATOR_ABI,
+            functionName: 'domainSeparator',
+        }),
+        // ---- writes ----
+        setLimit: ({ agentId, token, perTx, perPeriod, periodLen, account }) => {
+            const wc = requireWallet();
+            return wc.writeContract({
+                address,
+                abi: ENVOY_FACILITATOR_ABI,
+                functionName: 'setLimit',
+                args: [agentId, token, perTx, perPeriod, periodLen],
+                account: resolveAccount(account),
+                chain: wc.chain,
+            });
+        },
+        disableLimit: ({ agentId, token, account }) => {
+            const wc = requireWallet();
+            return wc.writeContract({
+                address,
+                abi: ENVOY_FACILITATOR_ABI,
+                functionName: 'disableLimit',
+                args: [agentId, token],
+                account: resolveAccount(account),
+                chain: wc.chain,
+            });
+        },
+        setTreasury: (newTreasury, account) => {
+            const wc = requireWallet();
+            return wc.writeContract({
+                address,
+                abi: ENVOY_FACILITATOR_ABI,
+                functionName: 'setTreasury',
+                args: [newTreasury],
+                account: resolveAccount(account),
+                chain: wc.chain,
+            });
+        },
+        // ---- hot path ----
+        pay: async (auth, signature, payOpts) => {
+            const wc = requireWallet();
+            const txHash = await wc.writeContract({
+                address,
+                abi: ENVOY_FACILITATOR_ABI,
+                functionName: 'pay',
+                args: [auth, signature],
+                account: resolveAccount(payOpts?.account),
+                chain: wc.chain,
+            });
+            const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+            for (const log of receipt.logs) {
+                if (getAddress(log.address) !== getAddress(address))
+                    continue;
+                try {
+                    const decoded = decodeEventLog({
+                        abi: ENVOY_FACILITATOR_ABI,
+                        data: log.data,
+                        topics: log.topics,
+                    });
+                    if (decoded.eventName === 'Settled') {
+                        return {
+                            challengeId: decoded.args.challengeId,
+                            agentId: decoded.args.agentId,
+                            merchant: decoded.args.merchant,
+                            token: decoded.args.token,
+                            amount: decoded.args.amount,
+                            fee: decoded.args.fee,
+                            nonce: decoded.args.nonce,
+                            signer: decoded.args.signer,
+                            txHash,
+                            blockNumber: receipt.blockNumber,
+                        };
+                    }
+                }
+                catch {
+                    // Not the event we wanted.
+                }
+            }
+            throw new Error(`pay: no Settled event in receipt ${txHash}`);
+        },
+        // ---- signing ----
+        signPaymentAuth: (auth) => signPaymentAuth(requireWallet(), { chainId, facilitatorAddress: address, auth }),
+    };
+}
+//# sourceMappingURL=facilitator.js.map

package/dist/esm/contracts/facilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.js","sourceRoot":"","sources":["../../../src/contracts/facilitator.ts"],"names":[],"mappings":"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"}

package/dist/esm/contracts/index.js

@@ -0,0 +1,8 @@
+// envoy on-chain layer — the EnvoyFacilitator contract on Celo.
+//
+// Identity and reputation are delegated to the canonical ERC-8004 registries
+// on Celo; helpers for those live under `src/identity/erc8004/`.
+export { ENVOY_CONTRACT_ADDRESSES, getEnvoyAddresses, CELO_MAINNET, CELO_SEPOLIA, } from './addresses.js';
+export { createEnvoyFacilitator, signPaymentAuth, paymentAuthDomain, paymentAuthTypedData, PAYMENT_AUTH_TYPES, } from './facilitator.js';
+export { ENVOY_FACILITATOR_ABI } from './abis/EnvoyFacilitator.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,6EAA6E;AAC7E,iEAAiE;AAEjE,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AASvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}