@agirails/sdk 2.3.0 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/README.md +45 -8
  2. package/dist/ACTPClient.d.ts +35 -1
  3. package/dist/ACTPClient.d.ts.map +1 -1
  4. package/dist/ACTPClient.js +156 -26
  5. package/dist/ACTPClient.js.map +1 -1
  6. package/dist/adapters/AdapterRouter.d.ts.map +1 -1
  7. package/dist/adapters/AdapterRouter.js.map +1 -1
  8. package/dist/adapters/BasicAdapter.d.ts +10 -1
  9. package/dist/adapters/BasicAdapter.d.ts.map +1 -1
  10. package/dist/adapters/BasicAdapter.js +36 -1
  11. package/dist/adapters/BasicAdapter.js.map +1 -1
  12. package/dist/cli/commands/init.d.ts +1 -0
  13. package/dist/cli/commands/init.d.ts.map +1 -1
  14. package/dist/cli/commands/init.js +210 -18
  15. package/dist/cli/commands/init.js.map +1 -1
  16. package/dist/cli/commands/publish.d.ts.map +1 -1
  17. package/dist/cli/commands/publish.js.map +1 -1
  18. package/dist/cli/commands/register.d.ts +16 -0
  19. package/dist/cli/commands/register.d.ts.map +1 -0
  20. package/dist/cli/commands/register.js +211 -0
  21. package/dist/cli/commands/register.js.map +1 -0
  22. package/dist/cli/index.js +3 -0
  23. package/dist/cli/index.js.map +1 -1
  24. package/dist/cli/utils/config.d.ts +6 -0
  25. package/dist/cli/utils/config.d.ts.map +1 -1
  26. package/dist/cli/utils/config.js.map +1 -1
  27. package/dist/config/networks.d.ts +20 -4
  28. package/dist/config/networks.d.ts.map +1 -1
  29. package/dist/config/networks.js +59 -27
  30. package/dist/config/networks.js.map +1 -1
  31. package/dist/config/publishPipeline.d.ts +14 -0
  32. package/dist/config/publishPipeline.d.ts.map +1 -1
  33. package/dist/config/publishPipeline.js +2 -1
  34. package/dist/config/publishPipeline.js.map +1 -1
  35. package/dist/erc8004/ERC8004Bridge.d.ts.map +1 -1
  36. package/dist/erc8004/ERC8004Bridge.js +6 -5
  37. package/dist/erc8004/ERC8004Bridge.js.map +1 -1
  38. package/dist/erc8004/ReputationReporter.d.ts.map +1 -1
  39. package/dist/erc8004/ReputationReporter.js +9 -12
  40. package/dist/erc8004/ReputationReporter.js.map +1 -1
  41. package/dist/index.d.ts +4 -0
  42. package/dist/index.d.ts.map +1 -1
  43. package/dist/index.js +7 -3
  44. package/dist/index.js.map +1 -1
  45. package/dist/level1/Agent.js +4 -4
  46. package/dist/level1/Agent.js.map +1 -1
  47. package/dist/protocol/ACTPKernel.d.ts +7 -1
  48. package/dist/protocol/ACTPKernel.d.ts.map +1 -1
  49. package/dist/protocol/ACTPKernel.js +13 -10
  50. package/dist/protocol/ACTPKernel.js.map +1 -1
  51. package/dist/protocol/EventMonitor.d.ts +14 -0
  52. package/dist/protocol/EventMonitor.d.ts.map +1 -1
  53. package/dist/protocol/EventMonitor.js +14 -0
  54. package/dist/protocol/EventMonitor.js.map +1 -1
  55. package/dist/runtime/BlockchainRuntime.d.ts +5 -0
  56. package/dist/runtime/BlockchainRuntime.d.ts.map +1 -1
  57. package/dist/runtime/BlockchainRuntime.js +1 -1
  58. package/dist/runtime/BlockchainRuntime.js.map +1 -1
  59. package/dist/storage/ArchiveBundleBuilder.d.ts.map +1 -1
  60. package/dist/storage/ArchiveBundleBuilder.js.map +1 -1
  61. package/dist/storage/ArweaveClient.d.ts.map +1 -1
  62. package/dist/storage/ArweaveClient.js +2 -0
  63. package/dist/storage/ArweaveClient.js.map +1 -1
  64. package/dist/storage/FilebaseClient.d.ts.map +1 -1
  65. package/dist/storage/FilebaseClient.js +2 -0
  66. package/dist/storage/FilebaseClient.js.map +1 -1
  67. package/dist/utils/ErrorRecoveryGuide.d.ts.map +1 -1
  68. package/dist/utils/ErrorRecoveryGuide.js +3 -2
  69. package/dist/utils/ErrorRecoveryGuide.js.map +1 -1
  70. package/dist/utils/IPFSClient.d.ts +3 -2
  71. package/dist/utils/IPFSClient.d.ts.map +1 -1
  72. package/dist/utils/IPFSClient.js +7 -5
  73. package/dist/utils/IPFSClient.js.map +1 -1
  74. package/dist/utils/computeTypeHash.js +1 -3
  75. package/dist/utils/computeTypeHash.js.map +1 -1
  76. package/dist/utils/retry.d.ts.map +1 -1
  77. package/dist/utils/retry.js +0 -1
  78. package/dist/utils/retry.js.map +1 -1
  79. package/dist/utils/validation.d.ts +2 -2
  80. package/dist/utils/validation.d.ts.map +1 -1
  81. package/dist/utils/validation.js +2 -2
  82. package/dist/utils/validation.js.map +1 -1
  83. package/dist/wallet/AutoWalletProvider.d.ts +77 -0
  84. package/dist/wallet/AutoWalletProvider.d.ts.map +1 -0
  85. package/dist/wallet/AutoWalletProvider.js +197 -0
  86. package/dist/wallet/AutoWalletProvider.js.map +1 -0
  87. package/dist/wallet/EOAWalletProvider.d.ts +21 -0
  88. package/dist/wallet/EOAWalletProvider.d.ts.map +1 -0
  89. package/dist/wallet/EOAWalletProvider.js +57 -0
  90. package/dist/wallet/EOAWalletProvider.js.map +1 -0
  91. package/dist/wallet/IWalletProvider.d.ts +115 -0
  92. package/dist/wallet/IWalletProvider.d.ts.map +1 -0
  93. package/dist/wallet/IWalletProvider.js +12 -0
  94. package/dist/wallet/IWalletProvider.js.map +1 -0
  95. package/dist/wallet/aa/BundlerClient.d.ts +70 -0
  96. package/dist/wallet/aa/BundlerClient.d.ts.map +1 -0
  97. package/dist/wallet/aa/BundlerClient.js +183 -0
  98. package/dist/wallet/aa/BundlerClient.js.map +1 -0
  99. package/dist/wallet/aa/DualNonceManager.d.ts +55 -0
  100. package/dist/wallet/aa/DualNonceManager.d.ts.map +1 -0
  101. package/dist/wallet/aa/DualNonceManager.js +131 -0
  102. package/dist/wallet/aa/DualNonceManager.js.map +1 -0
  103. package/dist/wallet/aa/PaymasterClient.d.ts +52 -0
  104. package/dist/wallet/aa/PaymasterClient.d.ts.map +1 -0
  105. package/dist/wallet/aa/PaymasterClient.js +115 -0
  106. package/dist/wallet/aa/PaymasterClient.js.map +1 -0
  107. package/dist/wallet/aa/TransactionBatcher.d.ts +87 -0
  108. package/dist/wallet/aa/TransactionBatcher.d.ts.map +1 -0
  109. package/dist/wallet/aa/TransactionBatcher.js +148 -0
  110. package/dist/wallet/aa/TransactionBatcher.js.map +1 -0
  111. package/dist/wallet/aa/UserOpBuilder.d.ts +71 -0
  112. package/dist/wallet/aa/UserOpBuilder.d.ts.map +1 -0
  113. package/dist/wallet/aa/UserOpBuilder.js +196 -0
  114. package/dist/wallet/aa/UserOpBuilder.js.map +1 -0
  115. package/dist/wallet/aa/constants.d.ts +54 -0
  116. package/dist/wallet/aa/constants.d.ts.map +1 -0
  117. package/dist/wallet/aa/constants.js +18 -0
  118. package/dist/wallet/aa/constants.js.map +1 -0
  119. package/package.json +4 -2
  120. package/src/ACTPClient.ts +217 -31
  121. package/src/adapters/AdapterRouter.ts +0 -1
  122. package/src/adapters/BasicAdapter.ts +41 -1
  123. package/src/cli/commands/init.ts +247 -19
  124. package/src/cli/commands/publish.ts +1 -2
  125. package/src/cli/commands/register.ts +233 -0
  126. package/src/cli/index.ts +4 -0
  127. package/src/cli/utils/config.ts +9 -0
  128. package/src/config/networks.ts +82 -27
  129. package/src/config/publishPipeline.ts +2 -2
  130. package/src/erc8004/ERC8004Bridge.ts +6 -5
  131. package/src/erc8004/ReputationReporter.ts +14 -18
  132. package/src/index.ts +12 -0
  133. package/src/level1/Agent.ts +5 -5
  134. package/src/protocol/ACTPKernel.ts +20 -10
  135. package/src/protocol/EventMonitor.ts +14 -0
  136. package/src/runtime/BlockchainRuntime.ts +7 -1
  137. package/src/storage/ArchiveBundleBuilder.ts +0 -2
  138. package/src/storage/ArweaveClient.ts +2 -1
  139. package/src/storage/FilebaseClient.ts +3 -3
  140. package/src/utils/ErrorRecoveryGuide.ts +4 -2
  141. package/src/utils/IPFSClient.ts +9 -7
  142. package/src/utils/computeTypeHash.ts +1 -3
  143. package/src/utils/retry.ts +0 -1
  144. package/src/utils/validation.ts +2 -2
  145. package/src/wallet/AutoWalletProvider.ts +294 -0
  146. package/src/wallet/EOAWalletProvider.ts +69 -0
  147. package/src/wallet/IWalletProvider.ts +133 -0
  148. package/src/wallet/aa/BundlerClient.ts +273 -0
  149. package/src/wallet/aa/DualNonceManager.ts +163 -0
  150. package/src/wallet/aa/PaymasterClient.ts +173 -0
  151. package/src/wallet/aa/TransactionBatcher.ts +240 -0
  152. package/src/wallet/aa/UserOpBuilder.ts +246 -0
  153. package/src/wallet/aa/constants.ts +60 -0
@@ -0,0 +1,57 @@
1
+ "use strict";
2
+ /**
3
+ * EOAWalletProvider — Tier 2 (BYOW) wallet implementation.
4
+ *
5
+ * Wraps an ethers.Wallet for traditional EOA signing.
6
+ * sendBatchTransaction() executes calls sequentially (no atomic batching).
7
+ * This is the backward-compatible path for agents that don't register.
8
+ *
9
+ * @module wallet/EOAWalletProvider
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.EOAWalletProvider = void 0;
13
+ class EOAWalletProvider {
14
+ constructor(wallet, chainId) {
15
+ this.wallet = wallet;
16
+ this.chainId = chainId;
17
+ }
18
+ getAddress() {
19
+ return this.wallet.address;
20
+ }
21
+ async sendTransaction(tx) {
22
+ const response = await this.wallet.sendTransaction({
23
+ to: tx.to,
24
+ data: tx.data,
25
+ value: tx.value ? BigInt(tx.value) : 0n,
26
+ });
27
+ const receipt = await response.wait();
28
+ return {
29
+ hash: receipt.hash,
30
+ success: receipt.status === 1,
31
+ };
32
+ }
33
+ async sendBatchTransaction(txs) {
34
+ if (txs.length === 0) {
35
+ throw new Error('sendBatchTransaction requires at least one transaction');
36
+ }
37
+ let lastReceipt;
38
+ for (const tx of txs) {
39
+ lastReceipt = await this.sendTransaction(tx);
40
+ if (!lastReceipt.success) {
41
+ return lastReceipt; // Fail fast
42
+ }
43
+ }
44
+ return lastReceipt;
45
+ }
46
+ getWalletInfo() {
47
+ return {
48
+ address: this.wallet.address,
49
+ tier: 'eoa',
50
+ supportsBatching: false,
51
+ gasSponsored: false,
52
+ chainId: this.chainId,
53
+ };
54
+ }
55
+ }
56
+ exports.EOAWalletProvider = EOAWalletProvider;
57
+ //# sourceMappingURL=EOAWalletProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EOAWalletProvider.js","sourceRoot":"","sources":["../../src/wallet/EOAWalletProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAUH,MAAa,iBAAiB;IAI5B,YAAY,MAAqB,EAAE,OAAe;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,EAAsB;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;YACjD,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;SACxC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO;YACL,IAAI,EAAE,OAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,OAAQ,CAAC,MAAM,KAAK,CAAC;SAC/B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,GAAyB;QAClD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,WAA2C,CAAC;QAChD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,WAAW,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,OAAO,WAAW,CAAC,CAAC,YAAY;YAClC,CAAC;QACH,CAAC;QACD,OAAO,WAAY,CAAC;IACtB,CAAC;IAED,aAAa;QACX,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,IAAI,EAAE,KAAK;YACX,gBAAgB,EAAE,KAAK;YACvB,YAAY,EAAE,KAAK;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAlDD,8CAkDC"}
@@ -0,0 +1,115 @@
1
+ /**
2
+ * IWalletProvider — Wallet abstraction for ACTP SDK.
3
+ *
4
+ * Enables pluggable wallet implementations:
5
+ * - EOAWalletProvider (Tier 2): Direct ethers.Wallet signing
6
+ * - AutoWalletProvider (Tier 1): CoinbaseSmartWallet + Paymaster (gasless)
7
+ *
8
+ * @module wallet/IWalletProvider
9
+ */
10
+ /**
11
+ * Low-level transaction request.
12
+ * Plain strings only — no ethers or viem types at the interface boundary.
13
+ */
14
+ export interface TransactionRequest {
15
+ /** Target contract address (0x-prefixed) */
16
+ to: string;
17
+ /** Calldata (0x-prefixed hex) */
18
+ data: string;
19
+ /** ETH value in wei (decimal string). Defaults to "0". */
20
+ value?: string;
21
+ }
22
+ /**
23
+ * Transaction receipt returned after submission.
24
+ */
25
+ export interface TransactionReceipt {
26
+ /** Transaction hash (EOA) or UserOp hash (AA) */
27
+ hash: string;
28
+ /** Whether the transaction succeeded */
29
+ success: boolean;
30
+ }
31
+ /**
32
+ * Wallet tier — determines gas behavior.
33
+ */
34
+ export type WalletTier = 'auto' | 'eoa';
35
+ /**
36
+ * Information about the wallet provider.
37
+ */
38
+ export interface WalletInfo {
39
+ /** The account address used for ACTP transactions */
40
+ address: string;
41
+ /** Wallet tier */
42
+ tier: WalletTier;
43
+ /** Whether this wallet supports atomic batching (AA = true, EOA = false) */
44
+ supportsBatching: boolean;
45
+ /** Whether gas is sponsored (AA with paymaster = true) */
46
+ gasSponsored: boolean;
47
+ /** Chain ID */
48
+ chainId: number;
49
+ }
50
+ /**
51
+ * Result of a batched ACTP payment via AA wallet.
52
+ */
53
+ export interface BatchedPayResult {
54
+ /** Pre-computed ACTP transaction ID (bytes32) */
55
+ txId: string;
56
+ /** Transaction hash from the UserOp */
57
+ hash: string;
58
+ /** Whether the UserOp succeeded */
59
+ success: boolean;
60
+ }
61
+ /**
62
+ * Parameters for batched ACTP payment.
63
+ */
64
+ export interface BatchedPayParams {
65
+ provider: string;
66
+ requester: string;
67
+ amount: string;
68
+ deadline: number;
69
+ disputeWindow: number;
70
+ serviceHash: string;
71
+ agentId: string;
72
+ contracts: {
73
+ usdc: string;
74
+ actpKernel: string;
75
+ escrowVault: string;
76
+ };
77
+ }
78
+ /**
79
+ * Wallet provider interface.
80
+ *
81
+ * All methods use plain strings (no ethers/viem types) to keep the
82
+ * interface decoupled from any specific library.
83
+ */
84
+ export interface IWalletProvider {
85
+ /**
86
+ * Get the account address used as requester in ACTP transactions.
87
+ * For AA wallets this is the Smart Wallet address (not the signer EOA).
88
+ */
89
+ getAddress(): string;
90
+ /**
91
+ * Send a single transaction.
92
+ */
93
+ sendTransaction(tx: TransactionRequest): Promise<TransactionReceipt>;
94
+ /**
95
+ * Send multiple transactions atomically (AA) or sequentially (EOA).
96
+ *
97
+ * AA wallets batch all calls into a single UserOp.
98
+ * EOA wallets execute them one by one and return the last receipt.
99
+ */
100
+ sendBatchTransaction(txs: TransactionRequest[]): Promise<TransactionReceipt>;
101
+ /**
102
+ * Get wallet metadata.
103
+ */
104
+ getWalletInfo(): WalletInfo;
105
+ /**
106
+ * Execute a batched ACTP payment atomically (approve + createTx + linkEscrow).
107
+ *
108
+ * Only available on AA wallets (supportsBatching: true).
109
+ * Handles ACTP nonce management internally via the DualNonceManager mutex.
110
+ *
111
+ * Returns undefined if batched payments are not supported.
112
+ */
113
+ payACTPBatched?(params: BatchedPayParams): Promise<BatchedPayResult>;
114
+ }
115
+ //# sourceMappingURL=IWalletProvider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IWalletProvider.d.ts","sourceRoot":"","sources":["../../src/wallet/IWalletProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,4EAA4E;IAC5E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAMD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,UAAU,IAAI,MAAM,CAAC;IAErB;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAErE;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE7E;;OAEG;IACH,aAAa,IAAI,UAAU,CAAC;IAE5B;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACtE"}
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ /**
3
+ * IWalletProvider — Wallet abstraction for ACTP SDK.
4
+ *
5
+ * Enables pluggable wallet implementations:
6
+ * - EOAWalletProvider (Tier 2): Direct ethers.Wallet signing
7
+ * - AutoWalletProvider (Tier 1): CoinbaseSmartWallet + Paymaster (gasless)
8
+ *
9
+ * @module wallet/IWalletProvider
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ //# sourceMappingURL=IWalletProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IWalletProvider.js","sourceRoot":"","sources":["../../src/wallet/IWalletProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}
@@ -0,0 +1,70 @@
1
+ /**
2
+ * BundlerClient — JSON-RPC client for ERC-4337 bundlers.
3
+ *
4
+ * Supports Coinbase (primary) and Pimlico (backup) bundlers.
5
+ * Handles gas estimation, UserOp submission, and receipt polling.
6
+ * Retry with exponential backoff on transient failures.
7
+ *
8
+ * @module wallet/aa/BundlerClient
9
+ */
10
+ import { UserOperationV06 } from './constants';
11
+ export interface BundlerConfig {
12
+ /** Primary bundler URL (Coinbase CDP) */
13
+ primaryUrl: string;
14
+ /** Backup bundler URL (Pimlico) */
15
+ backupUrl?: string;
16
+ /** Max retry attempts per endpoint */
17
+ maxRetries?: number;
18
+ /** Base delay for exponential backoff (ms) */
19
+ baseDelayMs?: number;
20
+ /** Timeout for individual requests (ms) */
21
+ timeoutMs?: number;
22
+ }
23
+ export interface UserOpReceipt {
24
+ /** UserOp hash */
25
+ userOpHash: string;
26
+ /** Transaction hash on-chain */
27
+ transactionHash: string;
28
+ /** Block number */
29
+ blockNumber: number;
30
+ /** Whether the UserOp execution succeeded */
31
+ success: boolean;
32
+ }
33
+ export declare class BundlerClient {
34
+ private readonly primaryUrl;
35
+ private readonly backupUrl;
36
+ private readonly maxRetries;
37
+ private readonly baseDelayMs;
38
+ private readonly timeoutMs;
39
+ private requestId;
40
+ constructor(config: BundlerConfig);
41
+ /**
42
+ * Estimate gas for a UserOp.
43
+ */
44
+ estimateUserOperationGas(userOp: UserOperationV06): Promise<{
45
+ callGasLimit: bigint;
46
+ verificationGasLimit: bigint;
47
+ preVerificationGas: bigint;
48
+ }>;
49
+ /**
50
+ * Submit a signed UserOp to the bundler.
51
+ * Returns the UserOp hash.
52
+ */
53
+ sendUserOperation(userOp: UserOperationV06): Promise<string>;
54
+ /**
55
+ * Get the receipt for a submitted UserOp.
56
+ * Returns null if not yet mined.
57
+ */
58
+ getUserOperationReceipt(userOpHash: string): Promise<UserOpReceipt | null>;
59
+ /**
60
+ * Wait for UserOp receipt with polling.
61
+ */
62
+ waitForReceipt(userOpHash: string, timeoutMs?: number, pollIntervalMs?: number): Promise<UserOpReceipt>;
63
+ /**
64
+ * Call primary, fall back to backup, with retries and backoff.
65
+ */
66
+ private callWithFallback;
67
+ private callWithRetry;
68
+ private jsonRpc;
69
+ }
70
+ //# sourceMappingURL=BundlerClient.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BundlerClient.d.ts","sourceRoot":"","sources":["../../../src/wallet/aa/BundlerClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAS/C,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;CAClB;AAaD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,SAAS,CAAK;gBAEV,MAAM,EAAE,aAAa;IAQjC;;OAEG;IACG,wBAAwB,CAC5B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB9F;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlE;;;OAGG;IACG,uBAAuB,CAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAqBhC;;OAEG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAe,EAC1B,cAAc,GAAE,MAAc,GAC7B,OAAO,CAAC,aAAa,CAAC;IAiBzB;;OAEG;YACW,gBAAgB;YAqBhB,aAAa;YA2Bb,OAAO;CA2CtB"}
@@ -0,0 +1,183 @@
1
+ "use strict";
2
+ /**
3
+ * BundlerClient — JSON-RPC client for ERC-4337 bundlers.
4
+ *
5
+ * Supports Coinbase (primary) and Pimlico (backup) bundlers.
6
+ * Handles gas estimation, UserOp submission, and receipt polling.
7
+ * Retry with exponential backoff on transient failures.
8
+ *
9
+ * @module wallet/aa/BundlerClient
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.BundlerClient = void 0;
13
+ const UserOpBuilder_1 = require("./UserOpBuilder");
14
+ const constants_1 = require("./constants");
15
+ const Logger_1 = require("../../utils/Logger");
16
+ // ============================================================================
17
+ // BundlerClient
18
+ // ============================================================================
19
+ class BundlerClient {
20
+ constructor(config) {
21
+ this.requestId = 1;
22
+ this.primaryUrl = config.primaryUrl;
23
+ this.backupUrl = config.backupUrl;
24
+ this.maxRetries = config.maxRetries ?? 2;
25
+ this.baseDelayMs = config.baseDelayMs ?? 1000;
26
+ this.timeoutMs = config.timeoutMs ?? 30000;
27
+ }
28
+ /**
29
+ * Estimate gas for a UserOp.
30
+ */
31
+ async estimateUserOperationGas(userOp) {
32
+ const result = await this.callWithFallback('eth_estimateUserOperationGas', [
33
+ (0, UserOpBuilder_1.serializeUserOp)(userOp),
34
+ constants_1.ENTRYPOINT_V06,
35
+ ]);
36
+ return {
37
+ callGasLimit: BigInt(result.callGasLimit),
38
+ verificationGasLimit: BigInt(result.verificationGasLimit),
39
+ preVerificationGas: BigInt(result.preVerificationGas),
40
+ };
41
+ }
42
+ /**
43
+ * Submit a signed UserOp to the bundler.
44
+ * Returns the UserOp hash.
45
+ */
46
+ async sendUserOperation(userOp) {
47
+ return this.callWithFallback('eth_sendUserOperation', [
48
+ (0, UserOpBuilder_1.serializeUserOp)(userOp),
49
+ constants_1.ENTRYPOINT_V06,
50
+ ]);
51
+ }
52
+ /**
53
+ * Get the receipt for a submitted UserOp.
54
+ * Returns null if not yet mined.
55
+ */
56
+ async getUserOperationReceipt(userOpHash) {
57
+ const result = await this.callWithFallback('eth_getUserOperationReceipt', [userOpHash]);
58
+ if (!result)
59
+ return null;
60
+ return {
61
+ userOpHash: result.userOpHash,
62
+ transactionHash: result.receipt.transactionHash,
63
+ blockNumber: parseInt(result.receipt.blockNumber, 16),
64
+ success: result.success,
65
+ };
66
+ }
67
+ /**
68
+ * Wait for UserOp receipt with polling.
69
+ */
70
+ async waitForReceipt(userOpHash, timeoutMs = 60000, pollIntervalMs = 2000) {
71
+ const start = Date.now();
72
+ while (Date.now() - start < timeoutMs) {
73
+ const receipt = await this.getUserOperationReceipt(userOpHash);
74
+ if (receipt)
75
+ return receipt;
76
+ await sleep(pollIntervalMs);
77
+ }
78
+ throw new Error(`UserOp ${userOpHash} not mined after ${timeoutMs}ms. ` +
79
+ 'The transaction may still be pending — check the bundler or block explorer.');
80
+ }
81
+ // ==========================================================================
82
+ // Internal
83
+ // ==========================================================================
84
+ /**
85
+ * Call primary, fall back to backup, with retries and backoff.
86
+ */
87
+ async callWithFallback(method, params) {
88
+ // Try primary
89
+ try {
90
+ return await this.callWithRetry(this.primaryUrl, method, params);
91
+ }
92
+ catch (primaryError) {
93
+ if (!this.backupUrl) {
94
+ throw primaryError;
95
+ }
96
+ Logger_1.sdkLogger.warn('Primary bundler failed, trying backup', {
97
+ method,
98
+ error: primaryError instanceof Error ? primaryError.message : String(primaryError),
99
+ });
100
+ }
101
+ // Try backup
102
+ return this.callWithRetry(this.backupUrl, method, params);
103
+ }
104
+ async callWithRetry(url, method, params) {
105
+ let lastError;
106
+ for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
107
+ try {
108
+ return await this.jsonRpc(url, method, params);
109
+ }
110
+ catch (error) {
111
+ lastError = error instanceof Error ? error : new Error(String(error));
112
+ // Don't retry non-transient errors
113
+ if (isNonTransient(lastError))
114
+ throw lastError;
115
+ if (attempt < this.maxRetries) {
116
+ const delay = this.baseDelayMs * Math.pow(2, attempt);
117
+ Logger_1.sdkLogger.warn('Bundler request failed, retrying', {
118
+ attempt: attempt + 1,
119
+ method,
120
+ delayMs: delay,
121
+ });
122
+ await sleep(delay);
123
+ }
124
+ }
125
+ }
126
+ throw lastError;
127
+ }
128
+ async jsonRpc(url, method, params) {
129
+ const body = JSON.stringify({
130
+ jsonrpc: '2.0',
131
+ id: this.requestId++,
132
+ method,
133
+ params,
134
+ });
135
+ const controller = new AbortController();
136
+ const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
137
+ try {
138
+ const response = await fetch(url, {
139
+ method: 'POST',
140
+ headers: { 'Content-Type': 'application/json' },
141
+ body,
142
+ signal: controller.signal,
143
+ });
144
+ if (!response.ok) {
145
+ throw new Error(`HTTP ${response.status}: ${response.statusText}`);
146
+ }
147
+ const json = (await response.json());
148
+ if (json.error) {
149
+ const err = new Error(`Bundler RPC error ${json.error.code}: ${json.error.message}`);
150
+ err.code = json.error.code;
151
+ err.data = json.error.data;
152
+ throw err;
153
+ }
154
+ return json.result;
155
+ }
156
+ finally {
157
+ clearTimeout(timeout);
158
+ }
159
+ }
160
+ }
161
+ exports.BundlerClient = BundlerClient;
162
+ // ============================================================================
163
+ // Helpers
164
+ // ============================================================================
165
+ function sleep(ms) {
166
+ return new Promise((resolve) => setTimeout(resolve, ms));
167
+ }
168
+ /**
169
+ * Detect non-transient errors that shouldn't be retried.
170
+ */
171
+ function isNonTransient(error) {
172
+ const code = error.code;
173
+ // AA errors from bundler (invalid signature, insufficient funds, etc.)
174
+ if (typeof code === 'number' && code >= -32700 && code <= -32600) {
175
+ return true; // JSON-RPC parse/invalid request errors
176
+ }
177
+ const msg = error.message.toLowerCase();
178
+ if (msg.includes('aa') && (msg.includes('invalid') || msg.includes('rejected'))) {
179
+ return true; // AA validation errors
180
+ }
181
+ return false;
182
+ }
183
+ //# sourceMappingURL=BundlerClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BundlerClient.js","sourceRoot":"","sources":["../../../src/wallet/aa/BundlerClient.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,55 @@
1
+ /**
2
+ * DualNonceManager — Manages both EntryPoint and ACTP nonces.
3
+ *
4
+ * ERC-4337 UserOps need two independent nonces:
5
+ * 1. EntryPoint nonce — anti-replay for the UserOp itself
6
+ * 2. ACTP nonce — used to compute deterministic txId
7
+ *
8
+ * This manager uses a sequential mutex queue to ensure:
9
+ * - Only one UserOp is in-flight at a time
10
+ * - ACTP nonce increments only on confirmed receipt
11
+ * - On failure, next call re-reads from chain
12
+ *
13
+ * @module wallet/aa/DualNonceManager
14
+ */
15
+ import { ethers } from 'ethers';
16
+ export declare class DualNonceManager {
17
+ private readonly provider;
18
+ private readonly senderAddress;
19
+ private readonly actpKernelAddress;
20
+ private readonly mutex;
21
+ /** Locally cached ACTP nonce — undefined means "re-read from chain" */
22
+ private cachedActpNonce;
23
+ constructor(provider: ethers.JsonRpcProvider, senderAddress: string, actpKernelAddress: string);
24
+ /**
25
+ * Execute a callback while holding the nonce mutex.
26
+ *
27
+ * The callback receives current nonces and must return whether
28
+ * the operation succeeded (to decide ACTP nonce increment).
29
+ *
30
+ * @param fn Callback receiving { entryPointNonce, actpNonce }
31
+ * @param incrementsActpNonce Whether success increments the ACTP nonce
32
+ */
33
+ enqueue<T>(fn: (nonces: {
34
+ entryPointNonce: bigint;
35
+ actpNonce: bigint;
36
+ }) => Promise<{
37
+ result: T;
38
+ success: boolean;
39
+ }>, incrementsActpNonce?: boolean): Promise<T>;
40
+ /**
41
+ * Read current EntryPoint nonce for the sender.
42
+ * Key 0 is the default key for CoinbaseSmartWallet.
43
+ */
44
+ private readEntryPointNonce;
45
+ /**
46
+ * Read current ACTP nonce for the requester.
47
+ * requesterNonces is public on ACTPKernel.
48
+ */
49
+ private readActpNonce;
50
+ /**
51
+ * Invalidate cached ACTP nonce (forces re-read on next operation).
52
+ */
53
+ invalidateCache(): void;
54
+ }
55
+ //# sourceMappingURL=DualNonceManager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DualNonceManager.d.ts","sourceRoot":"","sources":["../../../src/wallet/aa/DualNonceManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAgDhC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC,uEAAuE;IACvE,OAAO,CAAC,eAAe,CAAqB;gBAG1C,QAAQ,EAAE,MAAM,CAAC,eAAe,EAChC,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM;IAO3B;;;;;;;;OAQG;IACG,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QACtE,MAAM,EAAE,CAAC,CAAC;QACV,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,EACF,mBAAmB,GAAE,OAAc,GAClC,OAAO,CAAC,CAAC,CAAC;IA+Bb;;;OAGG;YACW,mBAAmB;IASjC;;;OAGG;YACW,aAAa;IAW3B;;OAEG;IACH,eAAe,IAAI,IAAI;CAGxB"}
@@ -0,0 +1,131 @@
1
+ "use strict";
2
+ /**
3
+ * DualNonceManager — Manages both EntryPoint and ACTP nonces.
4
+ *
5
+ * ERC-4337 UserOps need two independent nonces:
6
+ * 1. EntryPoint nonce — anti-replay for the UserOp itself
7
+ * 2. ACTP nonce — used to compute deterministic txId
8
+ *
9
+ * This manager uses a sequential mutex queue to ensure:
10
+ * - Only one UserOp is in-flight at a time
11
+ * - ACTP nonce increments only on confirmed receipt
12
+ * - On failure, next call re-reads from chain
13
+ *
14
+ * @module wallet/aa/DualNonceManager
15
+ */
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ exports.DualNonceManager = void 0;
18
+ const ethers_1 = require("ethers");
19
+ const constants_1 = require("./constants");
20
+ const Logger_1 = require("../../utils/Logger");
21
+ // ============================================================================
22
+ // ABI fragments
23
+ // ============================================================================
24
+ const ENTRYPOINT_NONCE_ABI = [
25
+ 'function getNonce(address sender, uint192 key) view returns (uint256)',
26
+ ];
27
+ const ACTP_KERNEL_NONCE_ABI = [
28
+ 'function requesterNonces(address requester) view returns (uint256)',
29
+ ];
30
+ // ============================================================================
31
+ // Mutex
32
+ // ============================================================================
33
+ class Mutex {
34
+ constructor() {
35
+ this.locked = false;
36
+ this.queue = [];
37
+ }
38
+ async acquire() {
39
+ if (!this.locked) {
40
+ this.locked = true;
41
+ return;
42
+ }
43
+ return new Promise((resolve) => {
44
+ this.queue.push(resolve);
45
+ });
46
+ }
47
+ release() {
48
+ if (this.queue.length > 0) {
49
+ const next = this.queue.shift();
50
+ next();
51
+ }
52
+ else {
53
+ this.locked = false;
54
+ }
55
+ }
56
+ }
57
+ // ============================================================================
58
+ // DualNonceManager
59
+ // ============================================================================
60
+ class DualNonceManager {
61
+ constructor(provider, senderAddress, actpKernelAddress) {
62
+ this.mutex = new Mutex();
63
+ this.provider = provider;
64
+ this.senderAddress = senderAddress;
65
+ this.actpKernelAddress = actpKernelAddress;
66
+ }
67
+ /**
68
+ * Execute a callback while holding the nonce mutex.
69
+ *
70
+ * The callback receives current nonces and must return whether
71
+ * the operation succeeded (to decide ACTP nonce increment).
72
+ *
73
+ * @param fn Callback receiving { entryPointNonce, actpNonce }
74
+ * @param incrementsActpNonce Whether success increments the ACTP nonce
75
+ */
76
+ async enqueue(fn, incrementsActpNonce = true) {
77
+ await this.mutex.acquire();
78
+ try {
79
+ // Read nonces
80
+ const entryPointNonce = await this.readEntryPointNonce();
81
+ const actpNonce = this.cachedActpNonce ?? await this.readActpNonce();
82
+ Logger_1.sdkLogger.info('Nonces acquired', {
83
+ entryPointNonce: entryPointNonce.toString(),
84
+ actpNonce: actpNonce.toString(),
85
+ });
86
+ const { result, success } = await fn({ entryPointNonce, actpNonce });
87
+ if (success && incrementsActpNonce) {
88
+ this.cachedActpNonce = actpNonce + 1n;
89
+ }
90
+ else if (!success) {
91
+ // Reset cache on failure — next call re-reads from chain
92
+ this.cachedActpNonce = undefined;
93
+ }
94
+ return result;
95
+ }
96
+ catch (error) {
97
+ // Reset on error
98
+ this.cachedActpNonce = undefined;
99
+ throw error;
100
+ }
101
+ finally {
102
+ this.mutex.release();
103
+ }
104
+ }
105
+ /**
106
+ * Read current EntryPoint nonce for the sender.
107
+ * Key 0 is the default key for CoinbaseSmartWallet.
108
+ */
109
+ async readEntryPointNonce() {
110
+ const entryPoint = new ethers_1.ethers.Contract(constants_1.ENTRYPOINT_V06, ENTRYPOINT_NONCE_ABI, this.provider);
111
+ return await entryPoint.getNonce(this.senderAddress, 0);
112
+ }
113
+ /**
114
+ * Read current ACTP nonce for the requester.
115
+ * requesterNonces is public on ACTPKernel.
116
+ */
117
+ async readActpNonce() {
118
+ const kernel = new ethers_1.ethers.Contract(this.actpKernelAddress, ACTP_KERNEL_NONCE_ABI, this.provider);
119
+ const nonce = await kernel.requesterNonces(this.senderAddress);
120
+ this.cachedActpNonce = nonce;
121
+ return nonce;
122
+ }
123
+ /**
124
+ * Invalidate cached ACTP nonce (forces re-read on next operation).
125
+ */
126
+ invalidateCache() {
127
+ this.cachedActpNonce = undefined;
128
+ }
129
+ }
130
+ exports.DualNonceManager = DualNonceManager;
131
+ //# sourceMappingURL=DualNonceManager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DualNonceManager.js","sourceRoot":"","sources":["../../../src/wallet/aa/DualNonceManager.ts"],"names":[],"mappings":"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"}