@dexterai/x402 3.2.1 → 3.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.
- package/README.md +122 -0
- package/dist/adapters/index.d.cts +2 -3
- package/dist/adapters/index.d.ts +2 -3
- package/dist/batch-settlement/index.cjs +1 -0
- package/dist/batch-settlement/index.d.cts +50 -0
- package/dist/batch-settlement/index.d.ts +50 -0
- package/dist/batch-settlement/index.js +1 -0
- package/dist/batch-settlement/seller/index.cjs +1 -0
- package/dist/batch-settlement/seller/index.d.cts +17 -0
- package/dist/batch-settlement/seller/index.d.ts +17 -0
- package/dist/batch-settlement/seller/index.js +1 -0
- package/dist/client/index.cjs +1 -1
- package/dist/client/index.d.cts +3 -5
- package/dist/client/index.d.ts +3 -5
- package/dist/client/index.js +1 -1
- package/dist/react/index.d.cts +4 -5
- package/dist/react/index.d.ts +4 -5
- package/dist/server/index.cjs +17 -17
- package/dist/server/index.d.cts +33 -31
- package/dist/server/index.d.ts +33 -31
- package/dist/server/index.js +17 -17
- package/dist/{sponsored-access-DP61rXDl.d.ts → sponsored-access-B2UCVgj3.d.cts} +1 -2
- package/dist/{sponsored-access-BuecDKXL.d.cts → sponsored-access-B2USBiVp.d.ts} +1 -2
- package/dist/types-BBhXpBwI.d.cts +60 -0
- package/dist/types-BIINnfB4.d.ts +142 -0
- package/dist/types-Bbt_SDZE.d.cts +142 -0
- package/dist/types-CwK4mPWV.d.ts +60 -0
- package/dist/{types-i7C2GiVY.d.cts → types-IqnDBsjL.d.cts} +226 -2
- package/dist/{types-BPKUVJEl.d.ts → types-IqnDBsjL.d.ts} +226 -2
- package/package.json +16 -3
- package/dist/types-CKiTYeJ-.d.cts +0 -218
- package/dist/types-CKiTYeJ-.d.ts +0 -218
package/README.md
CHANGED
|
@@ -176,6 +176,122 @@ function PayButton() {
|
|
|
176
176
|
|
|
177
177
|
---
|
|
178
178
|
|
|
179
|
+
## Batch settlement (EVM)
|
|
180
|
+
|
|
181
|
+
Batch settlement lets a buyer pre-fund an escrow channel once, make many
|
|
182
|
+
**discrete** paid API calls against it with cheap off-chain vouchers, and then
|
|
183
|
+
close the channel — the seller's many charges are batched into a handful of
|
|
184
|
+
on-chain transactions instead of one per call. It amortizes gas across
|
|
185
|
+
high-frequency discrete purchasing.
|
|
186
|
+
|
|
187
|
+
It is **not** a streaming primitive — it batches discrete purchases. EVM only
|
|
188
|
+
(Base, Arbitrum, Polygon). The buyer never needs a gas token: every step
|
|
189
|
+
(deposit, voucher, claim, settle, refund) is signature-based; the Dexter
|
|
190
|
+
facilitator submits the transactions and pays the gas.
|
|
191
|
+
|
|
192
|
+
### Buyer
|
|
193
|
+
|
|
194
|
+
```ts
|
|
195
|
+
import { openBatchChannel } from '@dexterai/x402/batch-settlement';
|
|
196
|
+
|
|
197
|
+
// Open a channel — signs an escrow deposit authorization (no gas needed).
|
|
198
|
+
const channel = await openBatchChannel({
|
|
199
|
+
wallet: evmWallet, // any { address, signTypedData }
|
|
200
|
+
network: 'eip155:8453', // Base
|
|
201
|
+
deposit: '0.30', // USDC escrowed for this channel
|
|
202
|
+
});
|
|
203
|
+
|
|
204
|
+
// Each call signs a cumulative voucher against the channel.
|
|
205
|
+
const a = await channel.fetch('https://api.example.com/v1/data');
|
|
206
|
+
const b = await channel.fetch('https://api.example.com/v1/data');
|
|
207
|
+
|
|
208
|
+
console.log(channel.state); // { deposited: '0.3', spent: '0.16', remaining: '0.14' }
|
|
209
|
+
|
|
210
|
+
// Done buying — signal you're finished with the channel.
|
|
211
|
+
const { closed } = await channel.close();
|
|
212
|
+
// closed === true. This is an intent signal, not a settlement: it does not
|
|
213
|
+
// move funds. The seller's settlement (below) claims what you spent and
|
|
214
|
+
// refunds the rest of your escrow automatically on the normal path.
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
Channel state auto-persists (localStorage in the browser, a file under
|
|
218
|
+
`~/.dexter-x402/channels` in Node). If the process restarts mid-session,
|
|
219
|
+
calling `openBatchChannel` again with the same wallet, network, and store
|
|
220
|
+
transparently resumes the open channel — the channel's state is recovered from
|
|
221
|
+
storage, or from on-chain state if storage was lost. Pass a custom `store` (any
|
|
222
|
+
`ChannelStore`) to persist elsewhere.
|
|
223
|
+
|
|
224
|
+
#### Escape hatch — `forceWithdraw()` / `finalizeWithdraw()`
|
|
225
|
+
|
|
226
|
+
If the seller never settles, the buyer can reclaim unspent escrow directly via
|
|
227
|
+
the channel contract's timed withdrawal:
|
|
228
|
+
|
|
229
|
+
```ts
|
|
230
|
+
// 1. Start the on-chain timed withdrawal.
|
|
231
|
+
await channel.forceWithdraw();
|
|
232
|
+
|
|
233
|
+
// 2. After the channel's withdraw delay elapses, finalize it.
|
|
234
|
+
await channel.finalizeWithdraw();
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
This is a last-resort safety net — **normal operation never needs it**, since
|
|
238
|
+
the seller's settlement returns unspent escrow on the standard path. Unlike
|
|
239
|
+
every other batch-settlement step, the escape hatch **costs the buyer gas**: it
|
|
240
|
+
submits transactions itself, so the buyer's wallet must be transaction-capable
|
|
241
|
+
(it must expose a `sendTransaction` method). A signature-only wallet cannot use
|
|
242
|
+
the escape hatch.
|
|
243
|
+
|
|
244
|
+
### Seller
|
|
245
|
+
|
|
246
|
+
`createBatchSettlementSeller(config)` returns a callable object that **is** an
|
|
247
|
+
Express request handler — mount it directly. It accepts batch-settlement
|
|
248
|
+
payments (each incoming voucher is verified and persisted to channel storage)
|
|
249
|
+
and collects them (claim → settle → refund). Dexter operates the delegate
|
|
250
|
+
authorizer, so the seller manages no signing key:
|
|
251
|
+
|
|
252
|
+
```ts
|
|
253
|
+
import { createBatchSettlementSeller } from '@dexterai/x402/batch-settlement/seller';
|
|
254
|
+
|
|
255
|
+
const seller = createBatchSettlementSeller({
|
|
256
|
+
payTo: '0xYourReceivingAddress',
|
|
257
|
+
network: 'eip155:8453', // Base
|
|
258
|
+
price: '0.08', // USDC per call
|
|
259
|
+
});
|
|
260
|
+
|
|
261
|
+
// The seller object IS the Express handler — mount it directly.
|
|
262
|
+
app.use('/api/data', seller);
|
|
263
|
+
|
|
264
|
+
// Auto-settlement runs in the background by default. On shutdown, stop the
|
|
265
|
+
// seller — this flushes a final settle so no collected vouchers are lost.
|
|
266
|
+
process.on('SIGTERM', async () => {
|
|
267
|
+
await seller.stop();
|
|
268
|
+
});
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
Settlement happens automatically via a background loop (on by default). To
|
|
272
|
+
settle on demand, call `seller.closeChannel(channelId)` for one channel or
|
|
273
|
+
`seller.closeAll()` for every open channel.
|
|
274
|
+
|
|
275
|
+
Mounting via `x402Middleware` also works — with `scheme: 'batch-settlement'` it
|
|
276
|
+
returns the same callable seller object, so you still get a `.stop()` /
|
|
277
|
+
`.closeAll()` / `.closeChannel()` handle:
|
|
278
|
+
|
|
279
|
+
```ts
|
|
280
|
+
import { x402Middleware } from '@dexterai/x402/server';
|
|
281
|
+
|
|
282
|
+
const seller = x402Middleware({
|
|
283
|
+
payTo: '0xYourReceivingAddress',
|
|
284
|
+
amount: '0.08',
|
|
285
|
+
network: 'eip155:8453',
|
|
286
|
+
scheme: 'batch-settlement',
|
|
287
|
+
});
|
|
288
|
+
|
|
289
|
+
app.use('/api/data', seller);
|
|
290
|
+
// seller.stop() / seller.closeAll() are available here too.
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
---
|
|
294
|
+
|
|
179
295
|
## Supported Networks
|
|
180
296
|
|
|
181
297
|
All networks supported by the [Dexter facilitator](https://x402.dexter.cash/supported). USDC on every chain.
|
|
@@ -251,6 +367,12 @@ import { createX402Client } from '@dexterai/x402/client';
|
|
|
251
367
|
// Client - Node.js (private key wallet)
|
|
252
368
|
import { wrapFetch, createKeypairWallet } from '@dexterai/x402/client';
|
|
253
369
|
|
|
370
|
+
// Batch settlement - EVM escrow channel buyer (gas amortization)
|
|
371
|
+
import { openBatchChannel } from '@dexterai/x402/batch-settlement';
|
|
372
|
+
|
|
373
|
+
// Batch settlement - EVM escrow channel seller runtime
|
|
374
|
+
import { createBatchSettlementSeller } from '@dexterai/x402/batch-settlement/seller';
|
|
375
|
+
|
|
254
376
|
// React hook
|
|
255
377
|
import { useX402Payment } from '@dexterai/x402/react';
|
|
256
378
|
|
|
@@ -1,7 +1,6 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export {
|
|
1
|
+
import { k as SolanaAdapter, l as EvmAdapter, C as ChainAdapter } from '../types-IqnDBsjL.cjs';
|
|
2
|
+
export { m as AdapterConfig, B as BalanceInfo, E as EvmWallet, G as GenericWallet, n as SignedTransaction, S as SolanaWallet, W as WalletSet, a as createEvmAdapter, c as createSolanaAdapter, p as isEvmWallet, o as isSolanaWallet } from '../types-IqnDBsjL.cjs';
|
|
3
3
|
export { A as ARBITRUM_ONE, l as AVALANCHE, B as BASE_MAINNET, j as BASE_SEPOLIA, f as BSC_MAINNET, i as BSC_STABLECOIN_ADDRESSES, h as BSC_USDC, g as BSC_USDT, E as ETHEREUM_MAINNET, O as OPTIMISM, P as PERMIT2_ADDRESS, k as POLYGON, m as SKALE_BASE, n as SKALE_BASE_SEPOLIA, d as SOLANA_DEVNET, S as SOLANA_MAINNET, e as SOLANA_TESTNET, o as USDC_ADDRESSES, X as X402_EXACT_PERMIT2_PROXY } from '../constants-qU-4U3L-.cjs';
|
|
4
|
-
import '../types-CKiTYeJ-.cjs';
|
|
5
4
|
|
|
6
5
|
/**
|
|
7
6
|
* Check if an asset address is a known USDC contract (any chain).
|
package/dist/adapters/index.d.ts
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export {
|
|
1
|
+
import { k as SolanaAdapter, l as EvmAdapter, C as ChainAdapter } from '../types-IqnDBsjL.js';
|
|
2
|
+
export { m as AdapterConfig, B as BalanceInfo, E as EvmWallet, G as GenericWallet, n as SignedTransaction, S as SolanaWallet, W as WalletSet, a as createEvmAdapter, c as createSolanaAdapter, p as isEvmWallet, o as isSolanaWallet } from '../types-IqnDBsjL.js';
|
|
3
3
|
export { A as ARBITRUM_ONE, l as AVALANCHE, B as BASE_MAINNET, j as BASE_SEPOLIA, f as BSC_MAINNET, i as BSC_STABLECOIN_ADDRESSES, h as BSC_USDC, g as BSC_USDT, E as ETHEREUM_MAINNET, O as OPTIMISM, P as PERMIT2_ADDRESS, k as POLYGON, m as SKALE_BASE, n as SKALE_BASE_SEPOLIA, d as SOLANA_DEVNET, S as SOLANA_MAINNET, e as SOLANA_TESTNET, o as USDC_ADDRESSES, X as X402_EXACT_PERMIT2_PROXY } from '../constants-qU-4U3L-.js';
|
|
4
|
-
import '../types-CKiTYeJ-.js';
|
|
5
4
|
|
|
6
5
|
/**
|
|
7
6
|
* Check if an asset address is a known USDC contract (any chain).
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"use strict";var T=Object.defineProperty;var et=Object.getOwnPropertyDescriptor;var nt=Object.getOwnPropertyNames;var at=Object.prototype.hasOwnProperty;var rt=(t,e)=>{for(var n in e)T(t,n,{get:e[n],enumerable:!0})},it=(t,e,n,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of nt(e))!at.call(t,r)&&r!==n&&T(t,r,{get:()=>e[r],enumerable:!(a=et(e,r))||a.enumerable});return t};var ot=t=>it(T({},"__esModule",{value:!0}),t);var ut={};rt(ut,{InsufficientBalanceError:()=>k,UnsupportedNetworkError:()=>f,WithdrawNotReadyError:()=>C,createFileChannelStore:()=>P,createLocalStorageChannelStore:()=>B,getDefaultChannelStore:()=>W,openBatchChannel:()=>Q,resumeBatchChannel:()=>V});module.exports=ot(ut);var l=require("viem"),y=require("viem/chains"),X=require("@x402/evm"),v=require("@x402/evm/batch-settlement/client"),I=require("@x402/core/client");var $=require("os"),O=require("path"),N=require("@x402/evm/batch-settlement/client");function P(t){return new N.FileClientChannelStorage({directory:t})}var E="dexter-x402-channel:";function B(t){return{async get(e){let n=t.getItem(E+e);return n?JSON.parse(n):void 0},async set(e,n){t.setItem(E+e,JSON.stringify(n))},async delete(e){t.removeItem(E+e)}}}function W(){let t=globalThis.localStorage;return t?B(t):P((0,O.join)((0,$.homedir)(),".dexter-x402","channels"))}var k=class extends Error{constructor(e){super(e),this.name="InsufficientBalanceError"}},f=class extends Error{constructor(e){super(e),this.name="UnsupportedNetworkError"}};var L=require("viem"),z=require("@x402/evm/batch-settlement/client"),g=require("@x402/evm"),C=class extends Error{constructor(e){super(e),this.name="WithdrawNotReadyError"}};function M(t,e){return t===0?0:t+e}var st=6,j=[{name:"payer",type:"address"},{name:"payerAuthorizer",type:"address"},{name:"receiver",type:"address"},{name:"receiverAuthorizer",type:"address"},{name:"token",type:"address"},{name:"withdrawDelay",type:"uint40"},{name:"salt",type:"bytes32"}],R=[{type:"function",name:"initiateWithdraw",inputs:[{name:"config",type:"tuple",components:j},{name:"amount",type:"uint128"}],outputs:[],stateMutability:"nonpayable"},{type:"function",name:"finalizeWithdraw",inputs:[{name:"config",type:"tuple",components:j}],outputs:[],stateMutability:"nonpayable"},{type:"function",name:"pendingWithdrawals",inputs:[{name:"channelId",type:"bytes32"}],outputs:[{name:"amount",type:"uint128"},{name:"initiatedAt",type:"uint40"}],stateMutability:"view"},{type:"function",name:"channels",inputs:[{name:"channelId",type:"bytes32"}],outputs:[{name:"balance",type:"uint128"},{name:"totalClaimed",type:"uint128"}],stateMutability:"view"}];function lt(t){if(Array.isArray(t))return{balance:BigInt(t[0]),totalClaimed:BigInt(t[1])};let e=t;return{balance:BigInt(e.balance),totalClaimed:BigInt(e.totalClaimed)}}function q(t){if(Array.isArray(t))return{amount:BigInt(t[0]),initiatedAt:Number(t[1])};let e=t;return{amount:BigInt(e.amount),initiatedAt:Number(e.initiatedAt)}}async function H(t){let{config:e,network:n,client:a,withdrawDelaySecs:r}=t,i=(0,z.computeChannelId)(e,n),s=t.amountAtomic;s===void 0&&(s=lt(await a.readContract({address:g.BATCH_SETTLEMENT_ADDRESS,abi:R,functionName:"channels",args:[i]})).balance);let c=await a.writeContract({address:g.BATCH_SETTLEMENT_ADDRESS,abi:R,functionName:"initiateWithdraw",args:[e,s]});await a.waitForTransactionReceipt({hash:c});let d=q(await a.readContract({address:g.BATCH_SETTLEMENT_ADDRESS,abi:R,functionName:"pendingWithdrawals",args:[i]}));return{initiateTx:c,finalizableAt:M(d.initiatedAt,r)}}async function _(t){let{config:e,network:n,client:a,withdrawDelaySecs:r}=t,i=(0,z.computeChannelId)(e,n),s=q(await a.readContract({address:g.BATCH_SETTLEMENT_ADDRESS,abi:R,functionName:"pendingWithdrawals",args:[i]}));if(s.initiatedAt===0)throw new C(`no withdrawal is pending for channel ${i} \u2014 call forceWithdraw first`);let c=M(s.initiatedAt,r),d=Math.floor(Date.now()/1e3);if(d<c)throw new C(`withdrawal for channel ${i} is not finalizable until ${c} (unix seconds) \u2014 ${c-d}s remaining`);let o=await a.writeContract({address:g.BATCH_SETTLEMENT_ADDRESS,abi:R,functionName:"finalizeWithdraw",args:[e]});return await a.waitForTransactionReceipt({hash:o}),{finalizeTx:o,withdrawnAmount:(0,L.formatUnits)(s.amount,st)}}var J={"eip155:8453":{chain:y.base,defaultRpc:"https://mainnet.base.org"},"eip155:42161":{chain:y.arbitrum,defaultRpc:"https://arb1.arbitrum.io/rpc"},"eip155:137":{chain:y.polygon,defaultRpc:"https://polygon-rpc.com"}};function G(t){let e=J[t.network];if(!e)throw new f(`batch-settlement is not available on network "${t.network}" \u2014 supported: ${Object.keys(J).join(", ")}`);let n=t.rpcUrl??e.defaultRpc,a=t.wallet.signTypedData;if(typeof a!="function")throw new Error("batch-settlement requires an EvmWallet that supports signTypedData (EIP-712)");let r=(0,l.createWalletClient)({account:{address:t.wallet.address,type:"json-rpc"},chain:e.chain,transport:(0,l.http)(n)}).extend(l.publicActions),i=t.wallet.sendTransaction,s=typeof i=="function",c=async u=>{let b=u.to??void 0;if(!b)throw new Error("batch-settlement escape hatch: transaction is missing a `to` address");let p=u.data??"0x";if(typeof i=="function")return await i.call(t.wallet,{to:b,data:p,value:u.value});throw new Error("batch-settlement: wallet has no sendTransaction")},d=Object.assign(r,{address:t.wallet.address,signTypedData:u=>a.call(t.wallet,u),sendTransaction:c}),o=(0,X.toClientEvmSigner)(d),m=new v.BatchSettlementEvmScheme(o,{storage:t.store,depositPolicy:{depositMultiplier:4},depositStrategy:()=>t.depositAtomic}),h=new I.x402Client;h.register(t.network,m);let w=new I.x402HTTPClient(h);return{scheme:m,x402Cli:h,httpClient:w,rpcUrl:n,withdrawClient:d,canSubmitTransactions:s}}var A=6;function ct(t,e){let n=e>t?0n:t-e;return{deposited:(0,l.formatUnits)(t,A),spent:(0,l.formatUnits)(e,A),remaining:(0,l.formatUnits)(n,A)}}function dt(t){let e=t.payload;if(!e||typeof e!="object")return"";let n=e.voucher;if(!n||typeof n!="object")return"";let a=n.channelId;return typeof a=="string"?a:""}function ht(t){let e=t.payload;if(!e||typeof e!="object")return;let n=e.channelConfig;if(!(!n||typeof n!="object"))return n}function K(t){let{stack:e,store:n,network:a}=t,r="",i,s=t.depositedAtomic,c=0n;async function d(){if(!r)return;let o=await(0,v.getChannel)(n,r);o&&(o.chargedCumulativeAmount!==void 0&&(c=BigInt(o.chargedCumulativeAmount)),s===0n&&o.balance!==void 0&&(s=BigInt(o.balance)))}return{get channelId(){return r},get network(){return a},get state(){return ct(s,c)},async fetch(o,m){let{httpClient:h}=e,w=await fetch(o,m);if(w.status!==402)return w;let F=h.getPaymentRequiredResponse(p=>w.headers.get(p),await w.clone().json().catch(()=>{})),u=2,b;for(let p=1;p<=u;p+=1){let S=await h.createPaymentPayload(F),D=dt(S);D&&(r=D);let U=ht(S);U&&(i=U);let Y=h.encodePaymentSignatureHeader(S),x=await fetch(o,{...m,headers:{...m?.headers??{},...Y}});b=x;let{recovered:Z}=await h.processPaymentResult(S,tt=>x.headers.get(tt),x.status);if(await d(),!(x.status===402&&Z&&p<u))return x}return b},async close(){return r&&await n.delete(r.toLowerCase()),{closed:!0}},async forceWithdraw(){if(!e.canSubmitTransactions)throw new Error("batch-settlement forceWithdraw requires a wallet with a sendTransaction method (the withdrawal escape hatch submits an on-chain transaction and the buyer pays gas; a signature-only wallet cannot use it).");if(!i)throw new Error("forceWithdraw is unavailable until the channel has resolved on-chain \u2014 make at least one fetch() against the channel first");return H({config:i,network:a,client:e.withdrawClient,withdrawDelaySecs:i.withdrawDelay})},async finalizeWithdraw(){if(!e.canSubmitTransactions)throw new Error("batch-settlement finalizeWithdraw requires a wallet with a sendTransaction method (the withdrawal escape hatch submits an on-chain transaction and the buyer pays gas; a signature-only wallet cannot use it).");if(!i)throw new Error("finalizeWithdraw is unavailable until the channel has resolved on-chain \u2014 make at least one fetch() against the channel first");return _({config:i,network:a,client:e.withdrawClient,withdrawDelaySecs:i.withdrawDelay})}}}async function Q(t){let e=t.store??W(),n;try{n=(0,l.parseUnits)(t.deposit,A)}catch{throw new Error(`deposit must be a valid USDC amount in decimal units (e.g. "0.30"), got "${t.deposit}"`)}if(n<=0n)throw new Error(`deposit must be a positive amount, got "${t.deposit}"`);let a=G({wallet:t.wallet,network:t.network,rpcUrl:t.rpcUrl,store:e,depositAtomic:n.toString()});return K({stack:a,store:e,network:t.network,depositedAtomic:n})}async function V(t){let e=t.store??W(),n=G({wallet:t.wallet,network:t.network,rpcUrl:t.rpcUrl,store:e,depositAtomic:"0"});return K({stack:n,store:e,network:t.network,depositedAtomic:0n})}0&&(module.exports={InsufficientBalanceError,UnsupportedNetworkError,WithdrawNotReadyError,createFileChannelStore,createLocalStorageChannelStore,getDefaultChannelStore,openBatchChannel,resumeBatchChannel});
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { O as OpenBatchChannelOptions, B as BatchSettlementChannel, R as ResumeBatchChannelOptions, C as ChannelStore } from '../types-Bbt_SDZE.cjs';
|
|
2
|
+
export { a as ChannelState, b as CloseReceipt, c as CloseResult, d as FinalizeWithdrawResult, F as ForceWithdrawResult, I as InsufficientBalanceError, U as UnsupportedNetworkError, W as WithdrawNotReadyError } from '../types-Bbt_SDZE.cjs';
|
|
3
|
+
import '@x402/evm/batch-settlement/client';
|
|
4
|
+
import '../types-IqnDBsjL.cjs';
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Opens a fresh batch-settlement escrow channel. No network call happens here:
|
|
8
|
+
* the channel is escrowed lazily on the FIRST `fetch`, where the upstream
|
|
9
|
+
* scheme signs an ERC-3009 deposit authorization (the facilitator pays the
|
|
10
|
+
* deposit gas — the buyer needs no native token, only USDC).
|
|
11
|
+
*
|
|
12
|
+
* The returned handle exposes accounting immediately (`deposited` from the
|
|
13
|
+
* `deposit` option, `spent` 0); `channelId` stays empty until the first fetch.
|
|
14
|
+
*
|
|
15
|
+
* @throws UnsupportedNetworkError when the network has no deployed contract.
|
|
16
|
+
* @throws Error when `deposit` is not a positive amount.
|
|
17
|
+
*/
|
|
18
|
+
declare function openBatchChannel(options: OpenBatchChannelOptions): Promise<BatchSettlementChannel>;
|
|
19
|
+
/**
|
|
20
|
+
* Resumes an already-open batch-settlement channel — same buyer wallet, same
|
|
21
|
+
* network, no new deposit. The upstream scheme recovers channel state from the
|
|
22
|
+
* `store` (or, with an RPC, from on-chain) on the first `fetch`.
|
|
23
|
+
*
|
|
24
|
+
* Because no deposit is opened, the handle's accounting starts at zero and is
|
|
25
|
+
* corrected from the recovered channel context (its on-chain `balance`) once
|
|
26
|
+
* the first `fetch` resolves the channel; `channelId`, `fetch`, and `close`
|
|
27
|
+
* are fully functional throughout.
|
|
28
|
+
*
|
|
29
|
+
* @throws UnsupportedNetworkError when the network has no deployed contract.
|
|
30
|
+
*/
|
|
31
|
+
declare function resumeBatchChannel(options: ResumeBatchChannelOptions): Promise<BatchSettlementChannel>;
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* File-backed ChannelStore for Node. This is the upstream FileClientChannelStorage,
|
|
35
|
+
* which persists each channel context as a JSON file under `{root}/client/`.
|
|
36
|
+
*/
|
|
37
|
+
declare function createFileChannelStore(root: string): ChannelStore;
|
|
38
|
+
/**
|
|
39
|
+
* localStorage-backed ChannelStore for browsers. Channel contexts are stored
|
|
40
|
+
* under a prefixed key so they never collide with other localStorage entries.
|
|
41
|
+
* Implements the upstream ClientChannelStorage interface (get / set / delete).
|
|
42
|
+
*/
|
|
43
|
+
declare function createLocalStorageChannelStore(storage: Storage): ChannelStore;
|
|
44
|
+
/**
|
|
45
|
+
* Returns the environment-appropriate default ChannelStore: localStorage in a
|
|
46
|
+
* browser, a file store at ~/.dexter-x402/channels in Node.
|
|
47
|
+
*/
|
|
48
|
+
declare function getDefaultChannelStore(): ChannelStore;
|
|
49
|
+
|
|
50
|
+
export { BatchSettlementChannel, ChannelStore, OpenBatchChannelOptions, ResumeBatchChannelOptions, createFileChannelStore, createLocalStorageChannelStore, getDefaultChannelStore, openBatchChannel, resumeBatchChannel };
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { O as OpenBatchChannelOptions, B as BatchSettlementChannel, R as ResumeBatchChannelOptions, C as ChannelStore } from '../types-BIINnfB4.js';
|
|
2
|
+
export { a as ChannelState, b as CloseReceipt, c as CloseResult, d as FinalizeWithdrawResult, F as ForceWithdrawResult, I as InsufficientBalanceError, U as UnsupportedNetworkError, W as WithdrawNotReadyError } from '../types-BIINnfB4.js';
|
|
3
|
+
import '@x402/evm/batch-settlement/client';
|
|
4
|
+
import '../types-IqnDBsjL.js';
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Opens a fresh batch-settlement escrow channel. No network call happens here:
|
|
8
|
+
* the channel is escrowed lazily on the FIRST `fetch`, where the upstream
|
|
9
|
+
* scheme signs an ERC-3009 deposit authorization (the facilitator pays the
|
|
10
|
+
* deposit gas — the buyer needs no native token, only USDC).
|
|
11
|
+
*
|
|
12
|
+
* The returned handle exposes accounting immediately (`deposited` from the
|
|
13
|
+
* `deposit` option, `spent` 0); `channelId` stays empty until the first fetch.
|
|
14
|
+
*
|
|
15
|
+
* @throws UnsupportedNetworkError when the network has no deployed contract.
|
|
16
|
+
* @throws Error when `deposit` is not a positive amount.
|
|
17
|
+
*/
|
|
18
|
+
declare function openBatchChannel(options: OpenBatchChannelOptions): Promise<BatchSettlementChannel>;
|
|
19
|
+
/**
|
|
20
|
+
* Resumes an already-open batch-settlement channel — same buyer wallet, same
|
|
21
|
+
* network, no new deposit. The upstream scheme recovers channel state from the
|
|
22
|
+
* `store` (or, with an RPC, from on-chain) on the first `fetch`.
|
|
23
|
+
*
|
|
24
|
+
* Because no deposit is opened, the handle's accounting starts at zero and is
|
|
25
|
+
* corrected from the recovered channel context (its on-chain `balance`) once
|
|
26
|
+
* the first `fetch` resolves the channel; `channelId`, `fetch`, and `close`
|
|
27
|
+
* are fully functional throughout.
|
|
28
|
+
*
|
|
29
|
+
* @throws UnsupportedNetworkError when the network has no deployed contract.
|
|
30
|
+
*/
|
|
31
|
+
declare function resumeBatchChannel(options: ResumeBatchChannelOptions): Promise<BatchSettlementChannel>;
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* File-backed ChannelStore for Node. This is the upstream FileClientChannelStorage,
|
|
35
|
+
* which persists each channel context as a JSON file under `{root}/client/`.
|
|
36
|
+
*/
|
|
37
|
+
declare function createFileChannelStore(root: string): ChannelStore;
|
|
38
|
+
/**
|
|
39
|
+
* localStorage-backed ChannelStore for browsers. Channel contexts are stored
|
|
40
|
+
* under a prefixed key so they never collide with other localStorage entries.
|
|
41
|
+
* Implements the upstream ClientChannelStorage interface (get / set / delete).
|
|
42
|
+
*/
|
|
43
|
+
declare function createLocalStorageChannelStore(storage: Storage): ChannelStore;
|
|
44
|
+
/**
|
|
45
|
+
* Returns the environment-appropriate default ChannelStore: localStorage in a
|
|
46
|
+
* browser, a file store at ~/.dexter-x402/channels in Node.
|
|
47
|
+
*/
|
|
48
|
+
declare function getDefaultChannelStore(): ChannelStore;
|
|
49
|
+
|
|
50
|
+
export { BatchSettlementChannel, ChannelStore, OpenBatchChannelOptions, ResumeBatchChannelOptions, createFileChannelStore, createLocalStorageChannelStore, getDefaultChannelStore, openBatchChannel, resumeBatchChannel };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{createWalletClient as Q,http as V,publicActions as Y,parseUnits as Z,formatUnits as A}from"viem";import{base as tt,arbitrum as et,polygon as nt}from"viem/chains";import{toClientEvmSigner as at}from"@x402/evm";import{BatchSettlementEvmScheme as rt,getChannel as it}from"@x402/evm/batch-settlement/client";import{x402Client as ot,x402HTTPClient as st}from"@x402/core/client";import{homedir as H}from"os";import{join as _}from"path";import{FileClientChannelStorage as J}from"@x402/evm/batch-settlement/client";function E(t){return new J({directory:t})}var R="dexter-x402-channel:";function P(t){return{async get(e){let n=t.getItem(R+e);return n?JSON.parse(n):void 0},async set(e,n){t.setItem(R+e,JSON.stringify(n))},async delete(e){t.removeItem(R+e)}}}function x(){let t=globalThis.localStorage;return t?P(t):E(_(H(),".dexter-x402","channels"))}var k=class extends Error{constructor(e){super(e),this.name="InsufficientBalanceError"}},C=class extends Error{constructor(e){super(e),this.name="UnsupportedNetworkError"}};import{formatUnits as X}from"viem";import{computeChannelId as z}from"@x402/evm/batch-settlement/client";import{BATCH_SETTLEMENT_ADDRESS as y}from"@x402/evm";var S=class extends Error{constructor(e){super(e),this.name="WithdrawNotReadyError"}};function F(t,e){return t===0?0:t+e}var G=6,B=[{name:"payer",type:"address"},{name:"payerAuthorizer",type:"address"},{name:"receiver",type:"address"},{name:"receiverAuthorizer",type:"address"},{name:"token",type:"address"},{name:"withdrawDelay",type:"uint40"},{name:"salt",type:"bytes32"}],b=[{type:"function",name:"initiateWithdraw",inputs:[{name:"config",type:"tuple",components:B},{name:"amount",type:"uint128"}],outputs:[],stateMutability:"nonpayable"},{type:"function",name:"finalizeWithdraw",inputs:[{name:"config",type:"tuple",components:B}],outputs:[],stateMutability:"nonpayable"},{type:"function",name:"pendingWithdrawals",inputs:[{name:"channelId",type:"bytes32"}],outputs:[{name:"amount",type:"uint128"},{name:"initiatedAt",type:"uint40"}],stateMutability:"view"},{type:"function",name:"channels",inputs:[{name:"channelId",type:"bytes32"}],outputs:[{name:"balance",type:"uint128"},{name:"totalClaimed",type:"uint128"}],stateMutability:"view"}];function K(t){if(Array.isArray(t))return{balance:BigInt(t[0]),totalClaimed:BigInt(t[1])};let e=t;return{balance:BigInt(e.balance),totalClaimed:BigInt(e.totalClaimed)}}function D(t){if(Array.isArray(t))return{amount:BigInt(t[0]),initiatedAt:Number(t[1])};let e=t;return{amount:BigInt(e.amount),initiatedAt:Number(e.initiatedAt)}}async function U(t){let{config:e,network:n,client:a,withdrawDelaySecs:s}=t,r=z(e,n),o=t.amountAtomic;o===void 0&&(o=K(await a.readContract({address:y,abi:b,functionName:"channels",args:[r]})).balance);let l=await a.writeContract({address:y,abi:b,functionName:"initiateWithdraw",args:[e,o]});await a.waitForTransactionReceipt({hash:l});let c=D(await a.readContract({address:y,abi:b,functionName:"pendingWithdrawals",args:[r]}));return{initiateTx:l,finalizableAt:F(c.initiatedAt,s)}}async function $(t){let{config:e,network:n,client:a,withdrawDelaySecs:s}=t,r=z(e,n),o=D(await a.readContract({address:y,abi:b,functionName:"pendingWithdrawals",args:[r]}));if(o.initiatedAt===0)throw new S(`no withdrawal is pending for channel ${r} \u2014 call forceWithdraw first`);let l=F(o.initiatedAt,s),c=Math.floor(Date.now()/1e3);if(c<l)throw new S(`withdrawal for channel ${r} is not finalizable until ${l} (unix seconds) \u2014 ${l-c}s remaining`);let i=await a.writeContract({address:y,abi:b,functionName:"finalizeWithdraw",args:[e]});return await a.waitForTransactionReceipt({hash:i}),{finalizeTx:i,withdrawnAmount:X(o.amount,G)}}var O={"eip155:8453":{chain:tt,defaultRpc:"https://mainnet.base.org"},"eip155:42161":{chain:et,defaultRpc:"https://arb1.arbitrum.io/rpc"},"eip155:137":{chain:nt,defaultRpc:"https://polygon-rpc.com"}};function N(t){let e=O[t.network];if(!e)throw new C(`batch-settlement is not available on network "${t.network}" \u2014 supported: ${Object.keys(O).join(", ")}`);let n=t.rpcUrl??e.defaultRpc,a=t.wallet.signTypedData;if(typeof a!="function")throw new Error("batch-settlement requires an EvmWallet that supports signTypedData (EIP-712)");let s=Q({account:{address:t.wallet.address,type:"json-rpc"},chain:e.chain,transport:V(n)}).extend(Y),r=t.wallet.sendTransaction,o=typeof r=="function",l=async h=>{let w=h.to??void 0;if(!w)throw new Error("batch-settlement escape hatch: transaction is missing a `to` address");let u=h.data??"0x";if(typeof r=="function")return await r.call(t.wallet,{to:w,data:u,value:h.value});throw new Error("batch-settlement: wallet has no sendTransaction")},c=Object.assign(s,{address:t.wallet.address,signTypedData:h=>a.call(t.wallet,h),sendTransaction:l}),i=at(c),p=new rt(i,{storage:t.store,depositPolicy:{depositMultiplier:4},depositStrategy:()=>t.depositAtomic}),d=new ot;d.register(t.network,p);let m=new st(d);return{scheme:p,x402Cli:d,httpClient:m,rpcUrl:n,withdrawClient:c,canSubmitTransactions:o}}var W=6;function lt(t,e){let n=e>t?0n:t-e;return{deposited:A(t,W),spent:A(e,W),remaining:A(n,W)}}function ct(t){let e=t.payload;if(!e||typeof e!="object")return"";let n=e.voucher;if(!n||typeof n!="object")return"";let a=n.channelId;return typeof a=="string"?a:""}function dt(t){let e=t.payload;if(!e||typeof e!="object")return;let n=e.channelConfig;if(!(!n||typeof n!="object"))return n}function j(t){let{stack:e,store:n,network:a}=t,s="",r,o=t.depositedAtomic,l=0n;async function c(){if(!s)return;let i=await it(n,s);i&&(i.chargedCumulativeAmount!==void 0&&(l=BigInt(i.chargedCumulativeAmount)),o===0n&&i.balance!==void 0&&(o=BigInt(i.balance)))}return{get channelId(){return s},get network(){return a},get state(){return lt(o,l)},async fetch(i,p){let{httpClient:d}=e,m=await fetch(i,p);if(m.status!==402)return m;let v=d.getPaymentRequiredResponse(u=>m.headers.get(u),await m.clone().json().catch(()=>{})),h=2,w;for(let u=1;u<=h;u+=1){let f=await d.createPaymentPayload(v),I=ct(f);I&&(s=I);let T=dt(f);T&&(r=T);let L=d.encodePaymentSignatureHeader(f),g=await fetch(i,{...p,headers:{...p?.headers??{},...L}});w=g;let{recovered:M}=await d.processPaymentResult(f,q=>g.headers.get(q),g.status);if(await c(),!(g.status===402&&M&&u<h))return g}return w},async close(){return s&&await n.delete(s.toLowerCase()),{closed:!0}},async forceWithdraw(){if(!e.canSubmitTransactions)throw new Error("batch-settlement forceWithdraw requires a wallet with a sendTransaction method (the withdrawal escape hatch submits an on-chain transaction and the buyer pays gas; a signature-only wallet cannot use it).");if(!r)throw new Error("forceWithdraw is unavailable until the channel has resolved on-chain \u2014 make at least one fetch() against the channel first");return U({config:r,network:a,client:e.withdrawClient,withdrawDelaySecs:r.withdrawDelay})},async finalizeWithdraw(){if(!e.canSubmitTransactions)throw new Error("batch-settlement finalizeWithdraw requires a wallet with a sendTransaction method (the withdrawal escape hatch submits an on-chain transaction and the buyer pays gas; a signature-only wallet cannot use it).");if(!r)throw new Error("finalizeWithdraw is unavailable until the channel has resolved on-chain \u2014 make at least one fetch() against the channel first");return $({config:r,network:a,client:e.withdrawClient,withdrawDelaySecs:r.withdrawDelay})}}}async function ht(t){let e=t.store??x(),n;try{n=Z(t.deposit,W)}catch{throw new Error(`deposit must be a valid USDC amount in decimal units (e.g. "0.30"), got "${t.deposit}"`)}if(n<=0n)throw new Error(`deposit must be a positive amount, got "${t.deposit}"`);let a=N({wallet:t.wallet,network:t.network,rpcUrl:t.rpcUrl,store:e,depositAtomic:n.toString()});return j({stack:a,store:e,network:t.network,depositedAtomic:n})}async function ut(t){let e=t.store??x(),n=N({wallet:t.wallet,network:t.network,rpcUrl:t.rpcUrl,store:e,depositAtomic:"0"});return j({stack:n,store:e,network:t.network,depositedAtomic:0n})}export{k as InsufficientBalanceError,C as UnsupportedNetworkError,S as WithdrawNotReadyError,E as createFileChannelStore,P as createLocalStorageChannelStore,x as getDefaultChannelStore,ht as openBatchChannel,ut as resumeBatchChannel};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"use strict";var R=Object.defineProperty;var N=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var D=(e,r)=>{for(var s in r)R(e,s,{get:r[s],enumerable:!0})},z=(e,r,s,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of O(r))!_.call(e,n)&&n!==s&&R(e,n,{get:()=>r[n],enumerable:!(o=N(r,n))||o.enumerable});return e};var Q=e=>z(R({},"__esModule",{value:!0}),e);var W={};D(W,{createBatchSettlementSeller:()=>E});module.exports=Q(W);var B=require("os"),U=require("path"),$=require("@x402/evm/batch-settlement/server");var C=require("@x402/core/server"),x=require("@x402/core/http"),A=require("@x402/evm/batch-settlement/server");function b(e){let r=e.verbose?console.log.bind(console,"[batch-settlement:seller]"):()=>{},s=new C.HTTPFacilitatorClient({url:e.facilitatorUrl}),o=new A.BatchSettlementEvmScheme(e.payTo,{storage:e.channelStore}),n=new C.x402ResourceServer(s).register(e.network,o),l=new x.x402HTTPResourceServer(n,{[e.route]:{accepts:{scheme:"batch-settlement",payTo:e.payTo,price:e.price,network:e.network},description:"batch-settlement protected route",mimeType:"application/json"}}),i=null;function u(){if(i)return i;let t=l.initialize();return t.catch(a=>{i===t&&(i=null),e.verbose?r("resource server initialize() failed:",a):console.error("[batch-settlement:seller] resource server initialize() failed:",a)}),i=t,t}let h=u();function d(t,a){if(t.headersSent)return;for(let[g,v]of Object.entries(a.headers))t.setHeader(g,v);t.status(a.status);let{body:m}=a;m==null?t.end():typeof m=="string"?t.send(m):t.json(m)}return{scheme:o,facilitator:s,handler:async(t,a,m)=>{try{await u();let g=t.get("host")??"",v=`${t.baseUrl}${t.path}`||"/",M={getHeader:y=>t.headers[y.toLowerCase()],getMethod:()=>t.method,getPath:()=>v,getUrl:()=>`${t.protocol}://${g}${t.originalUrl}`,getAcceptHeader:()=>t.headers.accept??"",getUserAgent:()=>t.headers["user-agent"]??"",getBody:()=>t.body??{},getQueryParams:()=>t.query,getQueryParam:y=>{let f=t.query[y];if(typeof f=="string"||Array.isArray(f))return f}},F=t.headers["payment-signature"]??t.headers["x-payment"],w={adapter:M,path:v,method:t.method,paymentHeader:F},p=await l.processHTTPRequest(w);if(r("processHTTPRequest ->",p.type),p.type==="no-payment-required"){m();return}if(p.type==="payment-error"){d(a,p.response);return}let j={request:w,responseBody:Buffer.alloc(0)},S=await l.processSettlement(p.paymentPayload,p.paymentRequirements,p.declaredExtensions,j);if(r("processSettlement ->",S.success?"success":`failure:${S.errorReason}`),!S.success){d(a,S.response);return}for(let[y,f]of Object.entries(S.headers))a.headersSent||a.setHeader(y,f);m()}catch(g){r("handler error:",g),a.headersSent||a.status(500).json({error:"Payment processing error"})}},ready:h}}var P=require("viem"),k=6;async function T(e){let{manager:r,store:s,channelId:o}=e,n=await s.get(o),l=BigInt(n?.chargedCumulativeAmount??"0"),i=BigInt(n?.balance??"0"),u=i>l?i-l:0n,{claims:h,settle:d}=await r.claimAndSettle(),c=await r.refund([o]),t=c.find(a=>a.channel===o)??c[0];return{claimTx:h[0]?.transaction??"",settleTx:d?.transaction??"",refundTx:t?.transaction??"",settledAmount:(0,P.formatUnits)(l,k),refundedAmount:(0,P.formatUnits)(u,k)}}async function I(e){let r=await e.store.list(),s=[];for(let o of r)try{let n=await T({manager:e.manager,store:e.store,channelId:o.channelId});s.push({channelId:o.channelId,...n})}catch(n){s.push({channelId:o.channelId,error:n instanceof Error?n.message:String(n)})}return s}function L(e){let r=!1,s=async()=>{try{await e.claimAndSettle()}catch(n){e.onError?.(n)}},o=setInterval(()=>{r||s()},e.claimIntervalMs);return typeof o.unref=="function"&&o.unref(),{async stop(){r||(r=!0,clearInterval(o),await s())}}}var q="https://x402.dexter.cash",G="GET /",H=new Set(["eip155:8453","eip155:42161","eip155:137"]);function K(e){return e===!1?null:e===void 0||e===!0?3e5:(e.claimIntervalSecs??300)*1e3}function E(e){if(!H.has(e.network))throw new Error(`batch-settlement is not supported on network "${e.network}" \u2014 supported: ${[...H].join(", ")}`);let r=e.facilitatorUrl??q,s=e.channelStore??new $.FileChannelStorage({directory:(0,U.join)((0,B.homedir)(),".dexter-x402","seller-channels")}),o=b({payTo:e.payTo,network:e.network,price:e.price,route:e.route??G,facilitatorUrl:r,channelStore:s,verbose:e.verbose}),n=o.scheme.createChannelManager(o.facilitator,e.network),l=async()=>{await n.claimAndSettle()},i=K(e.autoSettle),u=null;i!==null&&(u=L({claimAndSettle:l,claimIntervalMs:i,onError:t=>console.error("[batch-settlement:seller] auto-loop claim pass failed",t)}));let h=s,d=(t,a,m)=>{o.handler(t,a,m)},c=d;return c.middleware=()=>d,c.closeChannel=t=>T({manager:n,store:h,channelId:t}),c.closeAll=()=>I({manager:n,store:h}),c.stop=async()=>{u&&await u.stop()},c}0&&(module.exports={createBatchSettlementSeller});
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { a as BatchSettlementSellerConfig, B as BatchSettlementSeller } from '../../types-BBhXpBwI.cjs';
|
|
2
|
+
export { S as SellerCloseResult } from '../../types-BBhXpBwI.cjs';
|
|
3
|
+
import 'express';
|
|
4
|
+
import '@x402/evm/batch-settlement/server';
|
|
5
|
+
import '../../types-Bbt_SDZE.cjs';
|
|
6
|
+
import '@x402/evm/batch-settlement/client';
|
|
7
|
+
import '../../types-IqnDBsjL.cjs';
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Creates a batch-settlement seller runtime. The returned object is callable
|
|
11
|
+
* (usable directly as an Express RequestHandler) and exposes lifecycle +
|
|
12
|
+
* settlement methods. The auto-settlement loop starts immediately unless
|
|
13
|
+
* disabled.
|
|
14
|
+
*/
|
|
15
|
+
declare function createBatchSettlementSeller(config: BatchSettlementSellerConfig): BatchSettlementSeller;
|
|
16
|
+
|
|
17
|
+
export { BatchSettlementSeller, BatchSettlementSellerConfig, createBatchSettlementSeller };
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { a as BatchSettlementSellerConfig, B as BatchSettlementSeller } from '../../types-CwK4mPWV.js';
|
|
2
|
+
export { S as SellerCloseResult } from '../../types-CwK4mPWV.js';
|
|
3
|
+
import 'express';
|
|
4
|
+
import '@x402/evm/batch-settlement/server';
|
|
5
|
+
import '../../types-BIINnfB4.js';
|
|
6
|
+
import '@x402/evm/batch-settlement/client';
|
|
7
|
+
import '../../types-IqnDBsjL.js';
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Creates a batch-settlement seller runtime. The returned object is callable
|
|
11
|
+
* (usable directly as an Express RequestHandler) and exposes lifecycle +
|
|
12
|
+
* settlement methods. The auto-settlement loop starts immediately unless
|
|
13
|
+
* disabled.
|
|
14
|
+
*/
|
|
15
|
+
declare function createBatchSettlementSeller(config: BatchSettlementSellerConfig): BatchSettlementSeller;
|
|
16
|
+
|
|
17
|
+
export { BatchSettlementSeller, BatchSettlementSellerConfig, createBatchSettlementSeller };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{homedir as E}from"os";import{join as M}from"path";import{FileChannelStorage as F}from"@x402/evm/batch-settlement/server";import{HTTPFacilitatorClient as H,x402ResourceServer as B}from"@x402/core/server";import{x402HTTPResourceServer as U}from"@x402/core/http";import{BatchSettlementEvmScheme as $}from"@x402/evm/batch-settlement/server";function P(e){let s=e.verbose?console.log.bind(console,"[batch-settlement:seller]"):()=>{},a=new H({url:e.facilitatorUrl}),r=new $(e.payTo,{storage:e.channelStore}),o=new B(a).register(e.network,r),l=new U(o,{[e.route]:{accepts:{scheme:"batch-settlement",payTo:e.payTo,price:e.price,network:e.network},description:"batch-settlement protected route",mimeType:"application/json"}}),i=null;function u(){if(i)return i;let t=l.initialize();return t.catch(n=>{i===t&&(i=null),e.verbose?s("resource server initialize() failed:",n):console.error("[batch-settlement:seller] resource server initialize() failed:",n)}),i=t,t}let h=u();function d(t,n){if(t.headersSent)return;for(let[g,v]of Object.entries(n.headers))t.setHeader(g,v);t.status(n.status);let{body:m}=n;m==null?t.end():typeof m=="string"?t.send(m):t.json(m)}return{scheme:r,facilitator:a,handler:async(t,n,m)=>{try{await u();let g=t.get("host")??"",v=`${t.baseUrl}${t.path}`||"/",k={getHeader:y=>t.headers[y.toLowerCase()],getMethod:()=>t.method,getPath:()=>v,getUrl:()=>`${t.protocol}://${g}${t.originalUrl}`,getAcceptHeader:()=>t.headers.accept??"",getUserAgent:()=>t.headers["user-agent"]??"",getBody:()=>t.body??{},getQueryParams:()=>t.query,getQueryParam:y=>{let f=t.query[y];if(typeof f=="string"||Array.isArray(f))return f}},I=t.headers["payment-signature"]??t.headers["x-payment"],R={adapter:k,path:v,method:t.method,paymentHeader:I},p=await l.processHTTPRequest(R);if(s("processHTTPRequest ->",p.type),p.type==="no-payment-required"){m();return}if(p.type==="payment-error"){d(n,p.response);return}let L={request:R,responseBody:Buffer.alloc(0)},S=await l.processSettlement(p.paymentPayload,p.paymentRequirements,p.declaredExtensions,L);if(s("processSettlement ->",S.success?"success":`failure:${S.errorReason}`),!S.success){d(n,S.response);return}for(let[y,f]of Object.entries(S.headers))n.headersSent||n.setHeader(y,f);m()}catch(g){s("handler error:",g),n.headersSent||n.status(500).json({error:"Payment processing error"})}},ready:h}}import{formatUnits as T}from"viem";var w=6;async function C(e){let{manager:s,store:a,channelId:r}=e,o=await a.get(r),l=BigInt(o?.chargedCumulativeAmount??"0"),i=BigInt(o?.balance??"0"),u=i>l?i-l:0n,{claims:h,settle:d}=await s.claimAndSettle(),c=await s.refund([r]),t=c.find(n=>n.channel===r)??c[0];return{claimTx:h[0]?.transaction??"",settleTx:d?.transaction??"",refundTx:t?.transaction??"",settledAmount:T(l,w),refundedAmount:T(u,w)}}async function x(e){let s=await e.store.list(),a=[];for(let r of s)try{let o=await C({manager:e.manager,store:e.store,channelId:r.channelId});a.push({channelId:r.channelId,...o})}catch(o){a.push({channelId:r.channelId,error:o instanceof Error?o.message:String(o)})}return a}function A(e){let s=!1,a=async()=>{try{await e.claimAndSettle()}catch(o){e.onError?.(o)}},r=setInterval(()=>{s||a()},e.claimIntervalMs);return typeof r.unref=="function"&&r.unref(),{async stop(){s||(s=!0,clearInterval(r),await a())}}}var j="https://x402.dexter.cash",N="GET /",b=new Set(["eip155:8453","eip155:42161","eip155:137"]);function O(e){return e===!1?null:e===void 0||e===!0?3e5:(e.claimIntervalSecs??300)*1e3}function _(e){if(!b.has(e.network))throw new Error(`batch-settlement is not supported on network "${e.network}" \u2014 supported: ${[...b].join(", ")}`);let s=e.facilitatorUrl??j,a=e.channelStore??new F({directory:M(E(),".dexter-x402","seller-channels")}),r=P({payTo:e.payTo,network:e.network,price:e.price,route:e.route??N,facilitatorUrl:s,channelStore:a,verbose:e.verbose}),o=r.scheme.createChannelManager(r.facilitator,e.network),l=async()=>{await o.claimAndSettle()},i=O(e.autoSettle),u=null;i!==null&&(u=A({claimAndSettle:l,claimIntervalMs:i,onError:t=>console.error("[batch-settlement:seller] auto-loop claim pass failed",t)}));let h=a,d=(t,n,m)=>{r.handler(t,n,m)},c=d;return c.middleware=()=>d,c.closeChannel=t=>C({manager:o,store:h,channelId:t}),c.closeAll=()=>x({manager:o,store:h}),c.stop=async()=>{u&&await u.stop()},c}export{_ as createBatchSettlementSeller};
|
package/dist/client/index.cjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";var Et=Object.create;var De=Object.defineProperty;var St=Object.getOwnPropertyDescriptor;var wt=Object.getOwnPropertyNames;var xt=Object.getPrototypeOf,bt=Object.prototype.hasOwnProperty;var tt=(n,e)=>()=>(n&&(e=n(n=0)),e);var nt=(n,e)=>{for(var t in e)De(n,t,{get:e[t],enumerable:!0})},rt=(n,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of wt(e))!bt.call(n,o)&&o!==t&&De(n,o,{get:()=>e[o],enumerable:!(s=St(e,o))||s.enumerable});return n};var Ue=(n,e,t)=>(t=n!=null?Et(xt(n)):{},rt(e||!n||!n.__esModule?De(t,"default",{value:n,enumerable:!0}):t,n)),Tt=n=>rt(De({},"__esModule",{value:!0}),n);function Nt(n){if(n.length>=255)throw new TypeError("Alphabet too long");let e=new Uint8Array(256);for(let r=0;r<e.length;r++)e[r]=255;for(let r=0;r<n.length;r++){let p=n.charAt(r),h=p.charCodeAt(0);if(e[h]!==255)throw new TypeError(p+" is ambiguous");e[h]=r}let t=n.length,s=n.charAt(0),o=Math.log(t)/Math.log(256),a=Math.log(256)/Math.log(t);function d(r){if(r instanceof Uint8Array||(ArrayBuffer.isView(r)?r=new Uint8Array(r.buffer,r.byteOffset,r.byteLength):Array.isArray(r)&&(r=Uint8Array.from(r))),!(r instanceof Uint8Array))throw new TypeError("Expected Uint8Array");if(r.length===0)return"";let p=0,h=0,A=0,i=r.length;for(;A!==i&&r[A]===0;)A++,p++;let f=(i-A)*a+1>>>0,g=new Uint8Array(f);for(;A!==i;){let x=r[A],b=0;for(let C=f-1;(x!==0||b<h)&&C!==-1;C--,b++)x+=256*g[C]>>>0,g[C]=x%t>>>0,x=x/t>>>0;if(x!==0)throw new Error("Non-zero carry");h=b,A++}let u=f-h;for(;u!==f&&g[u]===0;)u++;let _=s.repeat(p);for(;u<f;++u)_+=n.charAt(g[u]);return _}function c(r){if(typeof r!="string")throw new TypeError("Expected String");if(r.length===0)return new Uint8Array;let p=0,h=0,A=0;for(;r[p]===s;)h++,p++;let i=(r.length-p)*o+1>>>0,f=new Uint8Array(i);for(;p<r.length;){let x=r.charCodeAt(p);if(x>255)return;let b=e[x];if(b===255)return;let C=0;for(let v=i-1;(b!==0||C<A)&&v!==-1;v--,C++)b+=t*f[v]>>>0,f[v]=b%256>>>0,b=b/256>>>0;if(b!==0)throw new Error("Non-zero carry");A=C,p++}let g=i-A;for(;g!==i&&f[g]===0;)g++;let u=new Uint8Array(h+(i-g)),_=h;for(;g!==i;)u[_++]=f[g++];return u}function l(r){let p=c(r);if(p)return p;throw new Error("Non-base"+t+" character")}return{encode:d,decodeUnsafe:c,decode:l}}var pt,lt=tt(()=>{"use strict";pt=Nt});var dt={};nt(dt,{default:()=>Bt});var vt,Bt,ut=tt(()=>{"use strict";lt();vt="123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz",Bt=pt(vt)});var Ot={};nt(Ot,{BASE_MAINNET:()=>F,DEXTER_FACILITATOR_URL:()=>Qe,KEYPAIR_SYMBOL:()=>Be,SOLANA_MAINNET:()=>q,USDC_MINT:()=>Ne,X402Error:()=>R,capabilitySearch:()=>et.capabilitySearch,createBudgetAccount:()=>gt,createEvmAdapter:()=>ye,createEvmKeypairWallet:()=>Xe,createKeypairWallet:()=>He,createSolanaAdapter:()=>ge,createX402Client:()=>Ve,fireImpressionBeacon:()=>ht,getPaymentReceipt:()=>je,getSponsoredAccessInfo:()=>Ye,getSponsoredRecommendations:()=>yt,isEvmKeypairWallet:()=>mt,isKeypairWallet:()=>ft,wrapFetch:()=>Je});module.exports=Tt(Ot);var Ee="solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",Me="solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",Le="solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z",q=Ee,Se=Me,we=Le,Z="eip155:8453",ae="eip155:84532",ie="eip155:42161",ce="eip155:137",pe="eip155:10",le="eip155:43114",de="eip155:56",ue="eip155:1187947933",fe="eip155:324705682",me="eip155:1",F=Z,ke=ae,xe=ie,be=ce,Te=pe,Re=le,_e=de,Pe=ue,Ce=fe,Ie=me,Ne="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",st="4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",ot="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",ze="0x55d398326f99059fF775485246999027B3197955",We="0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",$e={[de]:We,[Z]:ot,[ae]:"0x036CbD53842c5426634e7929541eC2318f3dCF7e",[ie]:"0xaf88d065e77c8cC2239327C5EDb3A432268e5831",[ce]:"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",[pe]:"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",[le]:"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",[ue]:"0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",[fe]:"0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",[me]:"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},Ke={[ze]:{symbol:"USDT",decimals:18},[We]:{symbol:"USDC",decimals:18}};var ee="0x000000000022D473030F116dDEE9F6B43aC78BA3",ve="0x402085c248EeA27D92E8b30b2C58ed07f9E20001",Ge={[de]:56,[Z]:8453,[ae]:84532,[ie]:42161,[ce]:137,[pe]:10,[le]:43114,[ue]:1187947933,[fe]:324705682,[me]:1},te={[Ee]:"https://api.dexter.cash/api/solana/rpc",[Me]:"https://api.devnet.solana.com",[Le]:"https://api.testnet.solana.com"},M={[de]:"https://bsc-dataseed1.binance.org",[Z]:"https://api.dexter.cash/api/base/rpc",[ae]:"https://sepolia.base.org",[ie]:"https://arb1.arbitrum.io/rpc",[ce]:"https://polygon-rpc.com",[pe]:"https://mainnet.optimism.io",[le]:"https://api.avax.network/ext/bc/C/rpc",[ue]:"https://skale-base.skalenodes.com/v1/base",[fe]:"https://base-sepolia-testnet.skalenodes.com/v1/jubilant-horrible-ancha",[me]:"https://eth.llamarpc.com"},Qe="https://x402.dexter.cash";var R=class n extends Error{code;details;constructor(e,t,s){super(t),this.name="X402Error",this.code=e,this.details=s,Object.setPrototypeOf(this,n.prototype)}};var D=require("@solana/web3.js"),O=require("@solana/spl-token");var Rt=12e3,_t=1;function ne(n){if(!n||typeof n!="object")return!1;let e=n;return"publicKey"in e&&"signTransaction"in e&&typeof e.signTransaction=="function"}var qe=class{name="Solana";networks=[q,Se,we];config;log;constructor(e={}){this.config=e,this.log=e.verbose?console.log.bind(console,"[x402:solana]"):()=>{}}canHandle(e){return!!(this.networks.includes(e)||e==="solana"||e==="solana-devnet"||e==="solana-testnet"||e.startsWith("solana:"))}getDefaultRpcUrl(e){return this.config.rpcUrls?.[e]?this.config.rpcUrls[e]:te[e]?te[e]:e==="solana"?te[q]:e==="solana-devnet"?te[Se]:e==="solana-testnet"?te[we]:te[q]}getAddress(e){return ne(e)?e.publicKey?.toBase58()??null:null}isConnected(e){return ne(e)?e.publicKey!==null:!1}async getBalance(e,t,s){if(!ne(t)||!t.publicKey)return 0;let o=s||this.getDefaultRpcUrl(e.network),a=new D.Connection(o,"confirmed"),d=new D.PublicKey(t.publicKey.toBase58()),c=new D.PublicKey(e.asset);try{let r=(await a.getAccountInfo(c,"confirmed"))?.owner.toBase58()===O.TOKEN_2022_PROGRAM_ID.toBase58()?O.TOKEN_2022_PROGRAM_ID:O.TOKEN_PROGRAM_ID,p=await(0,O.getAssociatedTokenAddress)(c,d,!1,r),h=await(0,O.getAccount)(a,p,void 0,r),A=e.extra?.decimals??6;return Number(h.amount)/Math.pow(10,A)}catch(l){if(l&&typeof l=="object"&&"name"in l&&(l.name==="TokenAccountNotFoundError"||l.name==="TokenInvalidAccountOwnerError"))return 0;throw l}}async buildTransaction(e,t,s){if(!ne(t))throw new Error("Invalid Solana wallet");if(!t.publicKey)throw new Error("Wallet not connected");let o=s||this.getDefaultRpcUrl(e.network),a=new D.Connection(o,"confirmed"),d=new D.PublicKey(t.publicKey.toBase58()),{payTo:c,asset:l,extra:r}=e,p=e.amount??e.maxAmountRequired;if(!p)throw new Error("Missing amount in payment requirements");if(!r?.feePayer)throw new Error("Missing feePayer in payment requirements");let h=new D.PublicKey(r.feePayer),A=new D.PublicKey(l),i=new D.PublicKey(c);this.log("Building transaction:",{from:d.toBase58(),to:c,amount:p,asset:l,feePayer:r.feePayer});let f=[];f.push(D.ComputeBudgetProgram.setComputeUnitLimit({units:Rt})),f.push(D.ComputeBudgetProgram.setComputeUnitPrice({microLamports:_t}));let g=await a.getAccountInfo(A,"confirmed");if(!g)throw new Error(`Token mint ${l} not found`);let u=g.owner.toBase58()===O.TOKEN_2022_PROGRAM_ID.toBase58()?O.TOKEN_2022_PROGRAM_ID:O.TOKEN_PROGRAM_ID,_=await(0,O.getMint)(a,A,void 0,u);typeof r?.decimals=="number"&&_.decimals!==r.decimals&&this.log(`Decimals mismatch: requirements say ${r.decimals}, mint says ${_.decimals}`);let x=await(0,O.getAssociatedTokenAddress)(A,d,!1,u),b=await(0,O.getAssociatedTokenAddress)(A,i,!1,u);if(!await a.getAccountInfo(x,"confirmed"))throw new Error(`No token account found for ${l}. Please ensure you have USDC in your wallet.`);if(!await a.getAccountInfo(b,"confirmed"))throw new Error(`Seller token account not found. The seller (${c}) must have a USDC account.`);let X=BigInt(p);f.push((0,O.createTransferCheckedInstruction)(x,A,b,d,X,_.decimals,[],u));let{blockhash:j}=await a.getLatestBlockhash("confirmed"),J=new D.TransactionMessage({payerKey:h,recentBlockhash:j,instructions:f}).compileToV0Message(),E=new D.VersionedTransaction(J),S=await t.signTransaction(E);return this.log("Transaction signed successfully"),{serialized:Buffer.from(S.serialize()).toString("base64")}}};function ge(n){return new qe(n)}var Pt={PermitWitnessTransferFrom:[{name:"permitted",type:"TokenPermissions"},{name:"spender",type:"address"},{name:"nonce",type:"uint256"},{name:"deadline",type:"uint256"},{name:"witness",type:"Witness"}],TokenPermissions:[{name:"token",type:"address"},{name:"amount",type:"uint256"}],Witness:[{name:"to",type:"address"},{name:"validAfter",type:"uint256"}]},at=BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");function re(n){if(!n||typeof n!="object")return!1;let e=n;return"address"in e&&typeof e.address=="string"&&e.address.startsWith("0x")}var Fe=class{name="EVM";networks=[_e,F,ke,Ie,xe,be,Te,Re,Pe,Ce];config;log;constructor(e={}){this.config=e,this.log=e.verbose?console.log.bind(console,"[x402:evm]"):()=>{}}canHandle(e){return!!(this.networks.includes(e)||e==="base"||e==="bsc"||e==="ethereum"||e==="arbitrum"||e==="polygon"||e==="optimism"||e==="avalanche"||e==="skale-base"||e==="skale-base-sepolia"||e.startsWith("eip155:"))}getDefaultRpcUrl(e){return this.config.rpcUrls?.[e]?this.config.rpcUrls[e]:M[e]?M[e]:e==="base"?M[F]:e==="bsc"?M[_e]:e==="ethereum"?M[Ie]:e==="arbitrum"?M[xe]:e==="polygon"?M[be]:e==="optimism"?M[Te]:e==="avalanche"?M[Re]:e==="skale-base"?M[Pe]:e==="skale-base-sepolia"?M[Ce]:M[F]}getAddress(e){return re(e)?e.address:null}isConnected(e){return re(e)?!!e.address:!1}getChainId(e){if(Ge[e])return Ge[e];if(e.startsWith("eip155:")){let t=e.split(":")[1];return parseInt(t,10)}return e==="base"?8453:e==="bsc"?56:e==="ethereum"?1:e==="arbitrum"?42161:8453}async getBalance(e,t,s){if(!re(t)||!t.address)return 0;let o=s||this.getDefaultRpcUrl(e.network);try{let a=this.encodeBalanceOf(t.address),d=await fetch(o,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_call",params:[{to:e.asset,data:a},"latest"]})});if(!d.ok)throw new Error(`RPC request failed: ${d.status}`);let c=await d.json();if(c.error)throw new Error(`RPC error: ${JSON.stringify(c.error)}`);if(!c.result||c.result==="0x")return 0;let l=BigInt(c.result),r=e.extra?.decimals??6;return Number(l)/Math.pow(10,r)}catch(a){throw a}}encodeBalanceOf(e){let t="0x70a08231",s=e.slice(2).toLowerCase().padStart(64,"0");return t+s}async buildTransaction(e,t,s){if(!re(t))throw new Error("Invalid EVM wallet");if(!t.address)throw new Error("Wallet not connected");if(e.scheme==="exact-approval")return this.buildApprovalTransaction(e,t,s);if(e.extra?.assetTransferMethod==="permit2")return this.buildPermit2Transaction(e,t,s);let{payTo:o,asset:a,extra:d}=e,c=e.amount??e.maxAmountRequired;if(!c)throw new Error("Missing amount in payment requirements");this.log("Building EVM transaction:",{from:t.address,to:o,amount:c,asset:a,network:e.network});let l=this.getChainId(e.network),r={name:d?.name??"USD Coin",version:d?.version??"2",chainId:BigInt(l),verifyingContract:a},p={TransferWithAuthorization:[{name:"from",type:"address"},{name:"to",type:"address"},{name:"value",type:"uint256"},{name:"validAfter",type:"uint256"},{name:"validBefore",type:"uint256"},{name:"nonce",type:"bytes32"}]},h=new Uint8Array(32);(globalThis.crypto??(await import("crypto")).webcrypto).getRandomValues(h);let A="0x"+[...h].map(x=>x.toString(16).padStart(2,"0")).join(""),i=Math.floor(Date.now()/1e3),f={from:t.address,to:o,value:c,validAfter:String(i-600),validBefore:String(i+(e.maxTimeoutSeconds||60)),nonce:A},g={from:t.address,to:o,value:BigInt(c),validAfter:BigInt(i-600),validBefore:BigInt(i+(e.maxTimeoutSeconds||60)),nonce:A};if(!t.signTypedData)throw new Error("Wallet does not support signTypedData (EIP-712)");let u=await t.signTypedData({domain:r,types:p,primaryType:"TransferWithAuthorization",message:g});return this.log("EIP-712 signature obtained"),{serialized:JSON.stringify({authorization:f,signature:u}),signature:u}}async buildApprovalTransaction(e,t,s){let{payTo:o,asset:a,extra:d}=e,c=e.amount??e.maxAmountRequired;if(!c)throw new Error("Missing amount in payment requirements");let l=d?.facilitatorContract;if(!l)throw new Error("exact-approval scheme requires extra.facilitatorContract from the facilitator. The /supported endpoint should provide this.");if(!t.signTypedData)throw new Error("Wallet does not support signTypedData (EIP-712)");this.log("Building approval-based transaction:",{from:t.address,to:o,amount:c,asset:a,network:e.network,facilitatorContract:l});let r=s||this.getDefaultRpcUrl(e.network),p=d?.fee??"0",h=BigInt(c)+BigInt(p),A=await this.readAllowance(r,a,t.address,l);if(A<h){if(!t.sendTransaction)throw new Error("BSC payments require a wallet that supports sendTransaction for the one-time token approval. Use createEvmKeypairWallet() or a browser wallet with transaction support.");let E=this.calculateApprovalAmount(c,p,d?.approvalStrategy);this.log(`Approving ${E} for ${l} (current allowance: ${A})`);let S=await t.sendTransaction({to:a,data:this.encodeApprove(l,E),value:0n});this.log(`Approval tx sent: ${S}`),await this.waitForReceipt(r,S),this.log("Approval confirmed")}else this.log("Sufficient allowance, skipping approval");let i=new Uint8Array(16);(globalThis.crypto??(await import("crypto")).webcrypto).getRandomValues(i);let f=[...i].reduce((E,S)=>E*256n+BigInt(S),0n).toString(),g=new Uint8Array(32);(globalThis.crypto??(await import("crypto")).webcrypto).getRandomValues(g);let u="0x"+[...g].map(E=>E.toString(16).padStart(2,"0")).join(""),x=Math.floor(Date.now()/1e3)+(e.maxTimeoutSeconds||300),b=d?.eip712Domain,C=b?{name:b.name,version:b.version,chainId:BigInt(b.chainId),verifyingContract:b.verifyingContract}:{name:"DexterBSCFacilitator",version:"1",chainId:BigInt(this.getChainId(e.network)),verifyingContract:l},v=d?.eip712Types??{Payment:[{name:"from",type:"address"},{name:"to",type:"address"},{name:"token",type:"address"},{name:"amount",type:"uint256"},{name:"fee",type:"uint256"},{name:"nonce",type:"uint256"},{name:"deadline",type:"uint256"},{name:"paymentId",type:"bytes32"}]},X={from:t.address,to:o,token:a,amount:BigInt(c),fee:BigInt(p),nonce:BigInt(f),deadline:BigInt(x),paymentId:u},j=await t.signTypedData({domain:C,types:v,primaryType:"Payment",message:X});this.log("EIP-712 Payment signature obtained");let J={from:t.address,to:o,token:a,amount:c,fee:p,nonce:f,deadline:x,paymentId:u,signature:j};return{serialized:JSON.stringify(J),signature:j}}async buildPermit2Transaction(e,t,s){let{payTo:o,asset:a}=e,d=e.amount??e.maxAmountRequired;if(!d)throw new Error("Missing amount in payment requirements");if(!t.signTypedData)throw new Error("Wallet does not support signTypedData (EIP-712)");this.log("Building Permit2 transaction:",{from:t.address,to:o,amount:d,asset:a,network:e.network});let c=s||this.getDefaultRpcUrl(e.network),l=await this.readAllowance(c,a,t.address,ee),r;if(l<BigInt(d)){let C=this.encodeApprove(ee,at);if(t.signTransaction){this.log(`Signing Permit2 approval for relay (current allowance: ${l})`);let v=this.getChainId(e.network),X=await this.readGasPrice(c),j=await this.readNonce(c,t.address),J=await t.signTransaction({to:a,data:C,chainId:v,gas:50000n,gasPrice:X,nonce:j});r={erc20ApprovalGasSponsoring:{info:{from:t.address,asset:a,spender:ee,amount:at.toString(),signedTransaction:J,version:"1"}}},this.log("Permit2 approval signed for facilitator relay")}else if(t.sendTransaction){this.log(`Approving Permit2 directly (current allowance: ${l})`);let v=await t.sendTransaction({to:a,data:C,value:0n});this.log(`Permit2 approval tx sent: ${v}`),await this.waitForReceipt(c,v),this.log("Permit2 approval confirmed")}else throw new Error("Permit2 payments require a wallet that supports signTransaction or sendTransaction for the one-time Permit2 approval. Use createEvmKeypairWallet() or a browser wallet with transaction support.")}else this.log("Sufficient Permit2 allowance, skipping approval");let p=new Uint8Array(32);(globalThis.crypto??(await import("crypto")).webcrypto).getRandomValues(p);let h=[...p].reduce((C,v)=>C*256n+BigInt(v),0n),A=Math.floor(Date.now()/1e3),i=A-600,f=A+(e.maxTimeoutSeconds||300),g=this.getChainId(e.network),u={name:"Permit2",chainId:BigInt(g),verifyingContract:ee},_={permitted:{token:a,amount:BigInt(d)},spender:ve,nonce:h,deadline:BigInt(f),witness:{to:o,validAfter:BigInt(i)}},x=await t.signTypedData({domain:u,types:Pt,primaryType:"PermitWitnessTransferFrom",message:_});this.log("Permit2 PermitWitnessTransferFrom signature obtained");let b={signature:x,permit2Authorization:{from:t.address,permitted:{token:a,amount:d},spender:ve,nonce:h.toString(),deadline:String(f),witness:{to:o,validAfter:String(i)}}};return{serialized:JSON.stringify(b),signature:x,extensions:r}}async readAllowance(e,t,s,o){let a="0xdd62ed3e",d=s.slice(2).toLowerCase().padStart(64,"0"),c=o.slice(2).toLowerCase().padStart(64,"0"),l=a+d+c;try{let p=await(await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_call",params:[{to:t,data:l},"latest"]})})).json();return p.error||!p.result||p.result==="0x"?0n:BigInt(p.result)}catch{return 0n}}encodeApprove(e,t){let s="0x095ea7b3",o=e.slice(2).toLowerCase().padStart(64,"0"),a=t.toString(16).padStart(64,"0");return s+o+a}async waitForReceipt(e,t,s=3e4){let o=Date.now();for(;Date.now()-o<s;){try{let d=await(await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_getTransactionReceipt",params:[t]})})).json();if(d.result){if(d.result.status==="0x0")throw new Error(`Approval transaction reverted: ${t}`);return}}catch(a){if(a instanceof Error&&a.message.includes("reverted"))throw a}await new Promise(a=>setTimeout(a,2e3))}throw new Error(`Approval transaction receipt timeout after ${s}ms: ${t}`)}async readGasPrice(e){try{let s=await(await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_gasPrice",params:[]})})).json();return s.result?BigInt(s.result):50000000n}catch{return 50000000n}}async readNonce(e,t){try{let o=await(await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_getTransactionCount",params:[t,"latest"]})})).json();return o.result?parseInt(o.result,16):0}catch{return 0}}calculateApprovalAmount(e,t,s){let o=BigInt(e)+BigInt(t);if(!s||s.mode==="exact")return o;let a=BigInt(s.defaultMultiple??10),d=o*a;if(s.maxCapUsd){let c=this.inferDecimals(e),l=BigInt(Math.floor(s.maxCapUsd*Math.pow(10,c)));if(d>l)return l}if(s.exactAboveUsd){let c=this.inferDecimals(e),l=BigInt(Math.floor(s.exactAboveUsd*Math.pow(10,c)));if(BigInt(e)>l)return o}return d}inferDecimals(e){return e.length>12?18:6}};function ye(n){return new Fe(n)}function Ze(n){if(n===Ne||n===st)return!0;let e=n.toLowerCase();for(let t of Object.values($e))if(t.toLowerCase()===e)return!0;for(let t of Object.keys(Ke))if(t.toLowerCase()===e)return!0;return!1}function Ct(n){return{[Ee]:"Solana",[Me]:"Solana Devnet",[Le]:"Solana Testnet",solana:"Solana","solana-devnet":"Solana Devnet","solana-testnet":"Solana Testnet",[Z]:"Base",[ae]:"Base Sepolia",[me]:"Ethereum",[ie]:"Arbitrum",[ce]:"Polygon",[pe]:"Optimism",[le]:"Avalanche",[de]:"BSC",[ue]:"SKALE Base",[fe]:"SKALE Base Sepolia",base:"Base","base-sepolia":"Base Sepolia",ethereum:"Ethereum",arbitrum:"Arbitrum",polygon:"Polygon",optimism:"Optimism",avalanche:"Avalanche",bsc:"BSC","skale-base":"SKALE Base","skale-base-sepolia":"SKALE Base Sepolia"}[n]||n}function it(n,e){let t=Ct(n);return t===n?e:t}async function It(n,e){if(typeof n=="string")return[n,e];if(n instanceof URL)return[n.href,e];let t=n,s=new Headers(t.headers);e?.headers&&new Headers(e.headers).forEach((d,c)=>s.set(c,d));let o={method:e?.method??t.method,headers:s,signal:e?.signal??t.signal,redirect:e?.redirect??t.redirect,credentials:e?.credentials??t.credentials},a=(o.method??"GET").toUpperCase();return e&&"body"in e?o.body=e.body:a!=="GET"&&a!=="HEAD"&&t.body&&(o.body=await t.arrayBuffer()),[t.url,o]}var ct=new WeakMap;function je(n){return ct.get(n)}function Ve(n){let{adapters:e=[ge({verbose:n.verbose}),ye({verbose:n.verbose})],wallets:t,wallet:s,preferredNetwork:o,rpcUrls:a={},maxAmountAtomic:d,fetch:c=globalThis.fetch,verbose:l=!1,accessPass:r,onPaymentRequired:p,maxRetries:h=0,retryDelayMs:A=500}=n,i=l?console.log.bind(console,"[x402]"):()=>{};async function f(E,S){let P;for(let w=0;w<=h;w++)try{let T=await c(E,S);if(T.status>=502&&T.status<=504&&w<h){i(`Retry ${w+1}/${h}: server returned ${T.status}`),await new Promise(I=>setTimeout(I,A*Math.pow(2,w)));continue}return T}catch(T){P=T,w<h&&(i(`Retry ${w+1}/${h}: ${T instanceof Error?T.message:"network error"}`),await new Promise(I=>setTimeout(I,A*Math.pow(2,w))))}throw P}let g=new Map;function u(E){try{let S=new URL(E).host,P=g.get(S);if(P&&P.expiresAt>Date.now()/1e3+10)return P.jwt;P&&g.delete(S)}catch{}return null}function _(E,S){try{let P=new URL(E).host,w=S.split(".");if(w.length===3){let T=JSON.parse(atob(w[1].replace(/-/g,"+").replace(/_/g,"/"))),I=Math.floor(Date.now()/1e3),B=I+86400,k=Math.min(typeof T.exp=="number"?T.exp:I,B);g.set(P,{jwt:S,expiresAt:k}),i("Access pass cached for",P,"| expires:",new Date(k*1e3).toISOString())}}catch{i("Failed to cache access pass")}}let x=t||{};s&&!x.solana&&ne(s)&&(x.solana=s),s&&!x.evm&&re(s)&&(x.evm=s);function b(E){let S=[];for(let P of E){let w=e.find(I=>I.canHandle(P.network));if(!w)continue;let T;w.name==="Solana"?T=x.solana:w.name==="EVM"&&(T=x.evm),T&&w.isConnected(T)&&S.push({accept:P,adapter:w,wallet:T})}if(S.length===0)return null;if(o){let P=S.find(w=>w.accept.network===o);if(P)return P}return S[0]}function C(E,S){return it(E,S)}function v(E,S){return a[E]||S.getDefaultRpcUrl(E)}async function X(E,S,P,w,T){let I="";if(r?.preferTier&&w.tiers){let m=w.tiers.find(K=>K.id===r.preferTier);if(m){if(r.maxSpend&&parseFloat(m.price)>parseFloat(r.maxSpend))throw new R("access_pass_exceeds_max_spend",`Access pass tier "${m.id}" costs $${m.price}, exceeds max spend $${r.maxSpend}`);I=`tier=${m.id}`}}else if(r?.preferDuration&&w.ratePerHour)I=`duration=${r.preferDuration}`;else if(w.tiers&&w.tiers.length>0){let m=w.tiers[0];if(r?.maxSpend&&parseFloat(m.price)>parseFloat(r.maxSpend))throw new R("access_pass_exceeds_max_spend",`Cheapest access pass costs $${m.price}, exceeds max spend $${r?.maxSpend}`);I=`tier=${m.id}`}let B=I?T.includes("?")?`${T}&${I}`:`${T}?${I}`:T;i("Purchasing access pass:",I||"default tier");let k=P.headers.get("PAYMENT-REQUIRED");if(!k)return null;let L;try{L=JSON.parse(atob(k))}catch{return null}let U=b(L.accepts);if(!U)return null;let{accept:N,adapter:$,wallet:he}=U;if($.name==="Solana"&&!N.extra?.feePayer)return null;let Y=N.extra?.decimals??(Ze(N.asset)?6:void 0);if(typeof Y!="number")return null;let Ae=N.amount??N.maxAmountRequired;if(!Ae)return null;let z=v(N.network,$);try{let m=await $.getBalance(N,he,z),K=Number(Ae)/Math.pow(10,Y);if(m<K){let At=C(N.network,$.name);throw new R("insufficient_balance",`Insufficient balance for access pass on ${At}. Have $${m.toFixed(4)}, need $${K.toFixed(4)}`)}}catch(m){if(m instanceof R)throw m}let V=await $.buildTransaction(N,he,z),se;$.name==="EVM"?se=JSON.parse(V.serialized):se={transaction:V.serialized};let G=typeof E=="string"?E:E instanceof URL?E.href:E.url,oe=L.resource;if(typeof L.resource=="string")try{let m=new URL(L.resource,G);["http:","https:"].includes(m.protocol)&&(oe=m.toString())}catch{}else if(L.resource&&typeof L.resource=="object"&&"url"in L.resource){let m=L.resource;try{let K=new URL(m.url,G);["http:","https:"].includes(K.protocol)&&(oe={...m,url:K.toString()})}catch{}}let Oe={x402Version:N.x402Version??2,resource:oe,accepted:N,payload:se};V.extensions&&(Oe.extensions=V.extensions);let H=btoa(JSON.stringify(Oe)),Q=await c(B,{...S,method:"POST",headers:{...S?.headers||{},"Content-Type":"application/json","PAYMENT-SIGNATURE":H}});if(!Q.ok)return i("Pass purchase failed:",Q.status),null;let y=Q.headers.get("ACCESS-PASS");return y&&(_(T,y),i("Access pass purchased and cached")),Q}async function j(E,S){let P=E;if(i("Making request:",P),r){let y=u(P);if(y){i("Using cached access pass");let m=await c(E,{...S,headers:{...S?.headers||{},Authorization:`Bearer ${y}`}});if(m.status!==401&&m.status!==402)return m;i("Cached pass rejected (status",m.status,"), purchasing new pass");try{g.delete(new URL(P).host)}catch{}}}let w=await f(E,S);if(w.status!==402)return w;i("Received 402 Payment Required");let T=w.headers.get("X-ACCESS-PASS-TIERS");if(r&&T){i("Server offers access passes, purchasing...");try{let y=JSON.parse(atob(T)),m=await X(E,S,w,y,P);if(m)return m}catch(y){i("Access pass purchase failed, falling back to per-request payment:",y)}}let I=w.headers.get("PAYMENT-REQUIRED");if(!I)throw new R("missing_payment_required_header","Server returned 402 but no PAYMENT-REQUIRED header");let B;try{let y=atob(I);B=JSON.parse(y)}catch{throw new R("invalid_payment_required","Failed to decode PAYMENT-REQUIRED header")}i("Payment requirements:",B);let k=w.headers.get("X-Quote-Hash");k&&i("Quote hash received:",k);let L=b(B.accepts);if(!L){let y=B.accepts.map(m=>m.network).join(", ");throw new R("no_matching_payment_option",`No connected wallet for any available network: ${y}`)}let{accept:U,adapter:N,wallet:$}=L;if(i(`Using ${N.name} for ${U.network}`),N.name==="Solana"&&!U.extra?.feePayer)throw new R("missing_fee_payer","Solana payment option missing feePayer in extra");let he=U.extra?.decimals??(Ze(U.asset)?6:void 0);if(typeof he!="number")throw new R("missing_decimals","Payment option missing decimals - provide in extra or use a known stablecoin");let Y=U.amount??U.maxAmountRequired;if(!Y)throw new R("missing_amount","Payment option missing amount");if(d&&BigInt(Y)>BigInt(d))throw new R("amount_exceeds_max",`Payment amount ${Y} exceeds maximum ${d}`);let Ae=v(U.network,N);i("Checking balance...");try{let y=await N.getBalance(U,$,Ae),m=Number(Y)/Math.pow(10,he);if(y<m){let K=C(U.network,N.name);throw new R("insufficient_balance",`Insufficient balance on ${K}. Have $${y.toFixed(4)}, need $${m.toFixed(4)}`)}i(`Balance OK: $${y.toFixed(4)} >= $${m.toFixed(4)}`)}catch(y){if(y instanceof R)throw y;i("Balance check failed (RPC error), proceeding with transaction attempt")}if(p&&!await p(U))throw new R("payment_rejected","Payment rejected by onPaymentRequired callback");i("Building transaction...");let z=await N.buildTransaction(U,$,Ae);i("Transaction signed");let V;N.name==="EVM"?V=JSON.parse(z.serialized):V={transaction:z.serialized};let se=E,G=B.resource;if(typeof B.resource=="string")try{let y=new URL(B.resource,se).toString();y!==B.resource&&i("Resolved relative resource URL:",B.resource,"\u2192",y),G=y}catch{G=B.resource}else if(B.resource&&typeof B.resource=="object"&&"url"in B.resource){let y=B.resource;try{let m=new URL(y.url,se).toString();m!==y.url&&(i("Resolved relative resource URL:",y.url,"\u2192",m),G={...y,url:m})}catch{}}let oe={x402Version:U.x402Version??2,resource:G,accepted:U,payload:V};z.extensions&&(oe.extensions=z.extensions);let Oe=btoa(JSON.stringify(oe));i("Retrying request with payment...");let H=await f(E,{...S,headers:{...S?.headers||{},"PAYMENT-SIGNATURE":Oe,...k?{"X-Quote-Hash":k}:{}}});if(i("Retry response status:",H.status),H.status===402){let y="unknown";try{let m=await H.clone().json();y=String(m.error||m.message||JSON.stringify(m)),i("Rejection reason:",y)}catch{}throw new R("payment_rejected",`Payment was rejected by the server: ${y}`)}let Q=H.headers.get("PAYMENT-RESPONSE");if(Q)try{let y=JSON.parse(atob(Q));ct.set(H,y),y.extensions&&i("Settlement extensions:",Object.keys(y.extensions).join(", "))}catch{}return H}async function J(E,S){let[P,w]=await It(E,S);return j(P,w)}return{fetch:J}}var W=require("@solana/web3.js"),Be=Symbol.for("x402:keypair");async function He(n){let e;if(typeof n=="string"){let t;try{let s=await Promise.resolve().then(()=>(ut(),dt)),o=s.decode??s.default?.decode;if(!o)throw new Error("decode not found");t=o}catch{throw new Error('The "bs58" package is required for base58 private keys. Install it with: npm install bs58')}try{let s=t(n);e=W.Keypair.fromSecretKey(s)}catch{try{let o=JSON.parse(n);if(Array.isArray(o))e=W.Keypair.fromSecretKey(Uint8Array.from(o));else throw new Error("Invalid private key format")}catch{throw new Error("Invalid private key. Expected base58 string or JSON array of bytes.")}}}else if(Array.isArray(n))e=W.Keypair.fromSecretKey(Uint8Array.from(n));else if(n instanceof Uint8Array)e=W.Keypair.fromSecretKey(n);else throw new Error("Invalid private key type. Expected string, number[], or Uint8Array.");return{publicKey:{toBase58:()=>e.publicKey.toBase58()},signTransaction:async t=>{if(t instanceof W.VersionedTransaction)return t.sign([e]),t;if(t instanceof W.Transaction)return t.sign(e),t;throw new Error("Unknown transaction type")},[Be]:e}}function ft(n){if(!n||typeof n!="object")return!1;let e=n;return Be in e&&e[Be]instanceof W.Keypair&&"publicKey"in e&&"signTransaction"in e}async function Xe(n){let e;try{e=(await import("viem/accounts")).privateKeyToAccount}catch{throw new Error("EVM wallet support requires viem as a peer dependency. Install with: npm install viem")}let t=n.startsWith("0x")?n:`0x${n}`,s=e(t);return{address:s.address,signTypedData:o=>s.signTypedData(o),signTransaction:o=>s.signTransaction({to:o.to,data:o.data,chainId:o.chainId,gas:o.gas,gasPrice:o.gasPrice,nonce:o.nonce,type:"legacy"})}}function mt(n){if(!n||typeof n!="object")return!1;let e=n;return"address"in e&&typeof e.address=="string"&&e.address.startsWith("0x")&&"signTypedData"in e&&typeof e.signTypedData=="function"}function Je(n,e){let{walletPrivateKey:t,evmPrivateKey:s,preferredNetwork:o,rpcUrls:a,maxAmountAtomic:d,verbose:c,accessPass:l,onPaymentRequired:r}=e;if(!t&&!s)throw new Error("At least one wallet private key is required (walletPrivateKey or evmPrivateKey)");let p={},h=[];t&&h.push(He(t).then(u=>{p.solana=u}).catch(u=>{console.warn(`[x402] Solana wallet init failed: ${u.message}`)})),s&&h.push(Xe(s).then(u=>{p.evm=u}).catch(u=>{console.warn(`[x402] EVM wallet init failed: ${u.message}`)}));let A=h.length>0?Promise.all(h):null,f=Ve({wallets:p,preferredNetwork:o,rpcUrls:a,maxAmountAtomic:d,fetch:n,verbose:c,accessPass:l,onPaymentRequired:r}),g=f.fetch.bind(f);return A?(async(u,_)=>(await A,g(u,_))):g}var et=require("@dexterai/x402-core");function gt(n){let{budget:e,allowedDomains:t,onPaymentRequired:s,...o}=n,a=parseFloat(e.total),d=e.perRequest?parseFloat(e.perRequest):1/0,c=e.perHour?parseFloat(e.perHour):1/0;if(isNaN(a)||a<=0)throw new Error("budget.total must be a positive number");let l=[],r=0;function p(){return l.reduce((f,g)=>f+g.amount,0)}function h(){let f=Date.now()-36e5;return l.filter(g=>g.timestamp>=f).reduce((g,u)=>g+u.amount,0)}let A=Je(fetch,{...o,onPaymentRequired:async f=>{let g=f.extra?.decimals??6,u=Number(f.amount)/Math.pow(10,g);if(u>d)throw new R("amount_exceeds_max",`$${u.toFixed(4)} exceeds per-request limit of $${d.toFixed(2)}`);let _=p();if(_+u>a)throw new R("amount_exceeds_max",`Budget exceeded. Spent $${_.toFixed(2)} of $${a.toFixed(2)}, payment: $${u.toFixed(4)}`);let x=h();if(x+u>c)throw new R("amount_exceeds_max",`Hourly limit ($${c.toFixed(2)}) exceeded. Spent $${x.toFixed(2)} this hour`);return r=u,s?s(f):!0}});return{fetch:(async(f,g)=>{let u=typeof f=="string"?f:f instanceof URL?f.href:f.url,_="unknown";try{_=new URL(u).hostname}catch{}if(t&&!t.some(b=>_===b||_.endsWith(`.${b}`)))throw new R("payment_rejected",`Domain "${_}" not in allowed domains`);r=0;let x=await A(f,g);if(r>0){let b="unknown",C=x.headers.get("PAYMENT-RESPONSE");if(C)try{b=JSON.parse(atob(C)).network||b}catch{}l.push({amount:r,domain:_,network:b,timestamp:Date.now()}),r=0}return x}),get spent(){return`$${p().toFixed(2)}`},get remaining(){return`$${(a-p()).toFixed(2)}`},get payments(){return l.length},get spentAmount(){return p()},get remainingAmount(){return a-p()},get ledger(){return l},get hourlySpend(){return h()},reset(){l=[]}}}function Ye(n){let e=je(n);if(e?.extensions?.["sponsored-access"])return e.extensions["sponsored-access"]}function yt(n){let e=Ye(n);if(e?.recommendations?.length)return e.recommendations}async function ht(n){let t=Ye(n)?.tracking?.impressionBeacon;if(!t)return!1;try{await fetch(t,{method:"GET"})}catch{}return!0}0&&(module.exports={BASE_MAINNET,DEXTER_FACILITATOR_URL,KEYPAIR_SYMBOL,SOLANA_MAINNET,USDC_MINT,X402Error,capabilitySearch,createBudgetAccount,createEvmAdapter,createEvmKeypairWallet,createKeypairWallet,createSolanaAdapter,createX402Client,fireImpressionBeacon,getPaymentReceipt,getSponsoredAccessInfo,getSponsoredRecommendations,isEvmKeypairWallet,isKeypairWallet,wrapFetch});
|
|
1
|
+
"use strict";var Et=Object.create;var De=Object.defineProperty;var St=Object.getOwnPropertyDescriptor;var wt=Object.getOwnPropertyNames;var xt=Object.getPrototypeOf,bt=Object.prototype.hasOwnProperty;var tt=(n,e)=>()=>(n&&(e=n(n=0)),e);var nt=(n,e)=>{for(var t in e)De(n,t,{get:e[t],enumerable:!0})},rt=(n,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of wt(e))!bt.call(n,o)&&o!==t&&De(n,o,{get:()=>e[o],enumerable:!(s=St(e,o))||s.enumerable});return n};var Ue=(n,e,t)=>(t=n!=null?Et(xt(n)):{},rt(e||!n||!n.__esModule?De(t,"default",{value:n,enumerable:!0}):t,n)),Tt=n=>rt(De({},"__esModule",{value:!0}),n);function Nt(n){if(n.length>=255)throw new TypeError("Alphabet too long");let e=new Uint8Array(256);for(let r=0;r<e.length;r++)e[r]=255;for(let r=0;r<n.length;r++){let p=n.charAt(r),y=p.charCodeAt(0);if(e[y]!==255)throw new TypeError(p+" is ambiguous");e[y]=r}let t=n.length,s=n.charAt(0),o=Math.log(t)/Math.log(256),a=Math.log(256)/Math.log(t);function d(r){if(r instanceof Uint8Array||(ArrayBuffer.isView(r)?r=new Uint8Array(r.buffer,r.byteOffset,r.byteLength):Array.isArray(r)&&(r=Uint8Array.from(r))),!(r instanceof Uint8Array))throw new TypeError("Expected Uint8Array");if(r.length===0)return"";let p=0,y=0,A=0,i=r.length;for(;A!==i&&r[A]===0;)A++,p++;let f=(i-A)*a+1>>>0,g=new Uint8Array(f);for(;A!==i;){let x=r[A],b=0;for(let C=f-1;(x!==0||b<y)&&C!==-1;C--,b++)x+=256*g[C]>>>0,g[C]=x%t>>>0,x=x/t>>>0;if(x!==0)throw new Error("Non-zero carry");y=b,A++}let u=f-y;for(;u!==f&&g[u]===0;)u++;let _=s.repeat(p);for(;u<f;++u)_+=n.charAt(g[u]);return _}function c(r){if(typeof r!="string")throw new TypeError("Expected String");if(r.length===0)return new Uint8Array;let p=0,y=0,A=0;for(;r[p]===s;)y++,p++;let i=(r.length-p)*o+1>>>0,f=new Uint8Array(i);for(;p<r.length;){let x=r.charCodeAt(p);if(x>255)return;let b=e[x];if(b===255)return;let C=0;for(let v=i-1;(b!==0||C<A)&&v!==-1;v--,C++)b+=t*f[v]>>>0,f[v]=b%256>>>0,b=b/256>>>0;if(b!==0)throw new Error("Non-zero carry");A=C,p++}let g=i-A;for(;g!==i&&f[g]===0;)g++;let u=new Uint8Array(y+(i-g)),_=y;for(;g!==i;)u[_++]=f[g++];return u}function l(r){let p=c(r);if(p)return p;throw new Error("Non-base"+t+" character")}return{encode:d,decodeUnsafe:c,decode:l}}var pt,lt=tt(()=>{"use strict";pt=Nt});var dt={};nt(dt,{default:()=>Bt});var vt,Bt,ut=tt(()=>{"use strict";lt();vt="123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz",Bt=pt(vt)});var Ot={};nt(Ot,{BASE_MAINNET:()=>F,DEXTER_FACILITATOR_URL:()=>Qe,KEYPAIR_SYMBOL:()=>Be,SOLANA_MAINNET:()=>q,USDC_MINT:()=>Ne,X402Error:()=>R,capabilitySearch:()=>et.capabilitySearch,createBudgetAccount:()=>gt,createEvmAdapter:()=>he,createEvmKeypairWallet:()=>Xe,createKeypairWallet:()=>He,createSolanaAdapter:()=>ge,createX402Client:()=>Ve,fireImpressionBeacon:()=>yt,getPaymentReceipt:()=>je,getSponsoredAccessInfo:()=>Ye,getSponsoredRecommendations:()=>ht,isEvmKeypairWallet:()=>mt,isKeypairWallet:()=>ft,wrapFetch:()=>Je});module.exports=Tt(Ot);var Ee="solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",Me="solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",Le="solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z",q=Ee,Se=Me,we=Le,Z="eip155:8453",ae="eip155:84532",ie="eip155:42161",ce="eip155:137",pe="eip155:10",le="eip155:43114",de="eip155:56",ue="eip155:1187947933",fe="eip155:324705682",me="eip155:1",F=Z,ke=ae,xe=ie,be=ce,Te=pe,Re=le,_e=de,Pe=ue,Ce=fe,Ie=me,Ne="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",st="4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",ot="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",ze="0x55d398326f99059fF775485246999027B3197955",We="0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",$e={[de]:We,[Z]:ot,[ae]:"0x036CbD53842c5426634e7929541eC2318f3dCF7e",[ie]:"0xaf88d065e77c8cC2239327C5EDb3A432268e5831",[ce]:"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",[pe]:"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",[le]:"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",[ue]:"0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",[fe]:"0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",[me]:"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},Ke={[ze]:{symbol:"USDT",decimals:18},[We]:{symbol:"USDC",decimals:18}};var ee="0x000000000022D473030F116dDEE9F6B43aC78BA3",ve="0x402085c248EeA27D92E8b30b2C58ed07f9E20001",Ge={[de]:56,[Z]:8453,[ae]:84532,[ie]:42161,[ce]:137,[pe]:10,[le]:43114,[ue]:1187947933,[fe]:324705682,[me]:1},te={[Ee]:"https://api.dexter.cash/api/solana/rpc",[Me]:"https://api.devnet.solana.com",[Le]:"https://api.testnet.solana.com"},M={[de]:"https://bsc-dataseed1.binance.org",[Z]:"https://api.dexter.cash/api/base/rpc",[ae]:"https://sepolia.base.org",[ie]:"https://arb1.arbitrum.io/rpc",[ce]:"https://polygon-rpc.com",[pe]:"https://mainnet.optimism.io",[le]:"https://api.avax.network/ext/bc/C/rpc",[ue]:"https://skale-base.skalenodes.com/v1/base",[fe]:"https://base-sepolia-testnet.skalenodes.com/v1/jubilant-horrible-ancha",[me]:"https://eth.llamarpc.com"},Qe="https://x402.dexter.cash";var R=class n extends Error{code;details;constructor(e,t,s){super(t),this.name="X402Error",this.code=e,this.details=s,Object.setPrototypeOf(this,n.prototype)}};var D=require("@solana/web3.js"),O=require("@solana/spl-token");var Rt=12e3,_t=1;function ne(n){if(!n||typeof n!="object")return!1;let e=n;return"publicKey"in e&&"signTransaction"in e&&typeof e.signTransaction=="function"}var qe=class{name="Solana";networks=[q,Se,we];config;log;constructor(e={}){this.config=e,this.log=e.verbose?console.log.bind(console,"[x402:solana]"):()=>{}}canHandle(e){return!!(this.networks.includes(e)||e==="solana"||e==="solana-devnet"||e==="solana-testnet"||e.startsWith("solana:"))}getDefaultRpcUrl(e){return this.config.rpcUrls?.[e]?this.config.rpcUrls[e]:te[e]?te[e]:e==="solana"?te[q]:e==="solana-devnet"?te[Se]:e==="solana-testnet"?te[we]:te[q]}getAddress(e){return ne(e)?e.publicKey?.toBase58()??null:null}isConnected(e){return ne(e)?e.publicKey!==null:!1}async getBalance(e,t,s){if(!ne(t)||!t.publicKey)return 0;let o=s||this.getDefaultRpcUrl(e.network),a=new D.Connection(o,"confirmed"),d=new D.PublicKey(t.publicKey.toBase58()),c=new D.PublicKey(e.asset);try{let r=(await a.getAccountInfo(c,"confirmed"))?.owner.toBase58()===O.TOKEN_2022_PROGRAM_ID.toBase58()?O.TOKEN_2022_PROGRAM_ID:O.TOKEN_PROGRAM_ID,p=await(0,O.getAssociatedTokenAddress)(c,d,!1,r),y=await(0,O.getAccount)(a,p,void 0,r),A=e.extra?.decimals??6;return Number(y.amount)/Math.pow(10,A)}catch(l){if(l&&typeof l=="object"&&"name"in l&&(l.name==="TokenAccountNotFoundError"||l.name==="TokenInvalidAccountOwnerError"))return 0;throw l}}async buildTransaction(e,t,s){if(!ne(t))throw new Error("Invalid Solana wallet");if(!t.publicKey)throw new Error("Wallet not connected");let o=s||this.getDefaultRpcUrl(e.network),a=new D.Connection(o,"confirmed"),d=new D.PublicKey(t.publicKey.toBase58()),{payTo:c,asset:l,extra:r}=e,p=e.amount??e.maxAmountRequired;if(!p)throw new Error("Missing amount in payment requirements");if(!r?.feePayer)throw new Error("Missing feePayer in payment requirements");let y=new D.PublicKey(r.feePayer),A=new D.PublicKey(l),i=new D.PublicKey(c);this.log("Building transaction:",{from:d.toBase58(),to:c,amount:p,asset:l,feePayer:r.feePayer});let f=[];f.push(D.ComputeBudgetProgram.setComputeUnitLimit({units:Rt})),f.push(D.ComputeBudgetProgram.setComputeUnitPrice({microLamports:_t}));let g=await a.getAccountInfo(A,"confirmed");if(!g)throw new Error(`Token mint ${l} not found`);let u=g.owner.toBase58()===O.TOKEN_2022_PROGRAM_ID.toBase58()?O.TOKEN_2022_PROGRAM_ID:O.TOKEN_PROGRAM_ID,_=await(0,O.getMint)(a,A,void 0,u);typeof r?.decimals=="number"&&_.decimals!==r.decimals&&this.log(`Decimals mismatch: requirements say ${r.decimals}, mint says ${_.decimals}`);let x=await(0,O.getAssociatedTokenAddress)(A,d,!1,u),b=await(0,O.getAssociatedTokenAddress)(A,i,!1,u);if(!await a.getAccountInfo(x,"confirmed"))throw new Error(`No token account found for ${l}. Please ensure you have USDC in your wallet.`);if(!await a.getAccountInfo(b,"confirmed"))throw new Error(`Seller token account not found. The seller (${c}) must have a USDC account.`);let X=BigInt(p);f.push((0,O.createTransferCheckedInstruction)(x,A,b,d,X,_.decimals,[],u));let{blockhash:j}=await a.getLatestBlockhash("confirmed"),J=new D.TransactionMessage({payerKey:y,recentBlockhash:j,instructions:f}).compileToV0Message(),E=new D.VersionedTransaction(J),S=await t.signTransaction(E);return this.log("Transaction signed successfully"),{serialized:Buffer.from(S.serialize()).toString("base64")}}};function ge(n){return new qe(n)}var Pt={PermitWitnessTransferFrom:[{name:"permitted",type:"TokenPermissions"},{name:"spender",type:"address"},{name:"nonce",type:"uint256"},{name:"deadline",type:"uint256"},{name:"witness",type:"Witness"}],TokenPermissions:[{name:"token",type:"address"},{name:"amount",type:"uint256"}],Witness:[{name:"to",type:"address"},{name:"validAfter",type:"uint256"}]},at=BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");function re(n){if(!n||typeof n!="object")return!1;let e=n;return"address"in e&&typeof e.address=="string"&&e.address.startsWith("0x")}var Fe=class{name="EVM";networks=[_e,F,ke,Ie,xe,be,Te,Re,Pe,Ce];config;log;constructor(e={}){this.config=e,this.log=e.verbose?console.log.bind(console,"[x402:evm]"):()=>{}}canHandle(e){return!!(this.networks.includes(e)||e==="base"||e==="bsc"||e==="ethereum"||e==="arbitrum"||e==="polygon"||e==="optimism"||e==="avalanche"||e==="skale-base"||e==="skale-base-sepolia"||e.startsWith("eip155:"))}getDefaultRpcUrl(e){return this.config.rpcUrls?.[e]?this.config.rpcUrls[e]:M[e]?M[e]:e==="base"?M[F]:e==="bsc"?M[_e]:e==="ethereum"?M[Ie]:e==="arbitrum"?M[xe]:e==="polygon"?M[be]:e==="optimism"?M[Te]:e==="avalanche"?M[Re]:e==="skale-base"?M[Pe]:e==="skale-base-sepolia"?M[Ce]:M[F]}getAddress(e){return re(e)?e.address:null}isConnected(e){return re(e)?!!e.address:!1}getChainId(e){if(Ge[e])return Ge[e];if(e.startsWith("eip155:")){let t=e.split(":")[1];return parseInt(t,10)}return e==="base"?8453:e==="bsc"?56:e==="ethereum"?1:e==="arbitrum"?42161:8453}async getBalance(e,t,s){if(!re(t)||!t.address)return 0;let o=s||this.getDefaultRpcUrl(e.network);try{let a=this.encodeBalanceOf(t.address),d=await fetch(o,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_call",params:[{to:e.asset,data:a},"latest"]})});if(!d.ok)throw new Error(`RPC request failed: ${d.status}`);let c=await d.json();if(c.error)throw new Error(`RPC error: ${JSON.stringify(c.error)}`);if(!c.result||c.result==="0x")return 0;let l=BigInt(c.result),r=e.extra?.decimals??6;return Number(l)/Math.pow(10,r)}catch(a){throw a}}encodeBalanceOf(e){let t="0x70a08231",s=e.slice(2).toLowerCase().padStart(64,"0");return t+s}async buildTransaction(e,t,s){if(!re(t))throw new Error("Invalid EVM wallet");if(!t.address)throw new Error("Wallet not connected");if(e.scheme==="exact-approval")return this.buildApprovalTransaction(e,t,s);if(e.extra?.assetTransferMethod==="permit2")return this.buildPermit2Transaction(e,t,s);let{payTo:o,asset:a,extra:d}=e,c=e.amount??e.maxAmountRequired;if(!c)throw new Error("Missing amount in payment requirements");this.log("Building EVM transaction:",{from:t.address,to:o,amount:c,asset:a,network:e.network});let l=this.getChainId(e.network),r={name:d?.name??"USD Coin",version:d?.version??"2",chainId:BigInt(l),verifyingContract:a},p={TransferWithAuthorization:[{name:"from",type:"address"},{name:"to",type:"address"},{name:"value",type:"uint256"},{name:"validAfter",type:"uint256"},{name:"validBefore",type:"uint256"},{name:"nonce",type:"bytes32"}]},y=new Uint8Array(32);(globalThis.crypto??(await import("crypto")).webcrypto).getRandomValues(y);let A="0x"+[...y].map(x=>x.toString(16).padStart(2,"0")).join(""),i=Math.floor(Date.now()/1e3),f={from:t.address,to:o,value:c,validAfter:String(i-600),validBefore:String(i+(e.maxTimeoutSeconds||60)),nonce:A},g={from:t.address,to:o,value:BigInt(c),validAfter:BigInt(i-600),validBefore:BigInt(i+(e.maxTimeoutSeconds||60)),nonce:A};if(!t.signTypedData)throw new Error("Wallet does not support signTypedData (EIP-712)");let u=await t.signTypedData({domain:r,types:p,primaryType:"TransferWithAuthorization",message:g});return this.log("EIP-712 signature obtained"),{serialized:JSON.stringify({authorization:f,signature:u}),signature:u}}async buildApprovalTransaction(e,t,s){let{payTo:o,asset:a,extra:d}=e,c=e.amount??e.maxAmountRequired;if(!c)throw new Error("Missing amount in payment requirements");let l=d?.facilitatorContract;if(!l)throw new Error("exact-approval scheme requires extra.facilitatorContract from the facilitator. The /supported endpoint should provide this.");if(!t.signTypedData)throw new Error("Wallet does not support signTypedData (EIP-712)");this.log("Building approval-based transaction:",{from:t.address,to:o,amount:c,asset:a,network:e.network,facilitatorContract:l});let r=s||this.getDefaultRpcUrl(e.network),p=d?.fee??"0",y=BigInt(c)+BigInt(p),A=await this.readAllowance(r,a,t.address,l);if(A<y){if(!t.sendTransaction)throw new Error("BSC payments require a wallet that supports sendTransaction for the one-time token approval. Use createEvmKeypairWallet() or a browser wallet with transaction support.");let E=this.calculateApprovalAmount(c,p,d?.approvalStrategy);this.log(`Approving ${E} for ${l} (current allowance: ${A})`);let S=await t.sendTransaction({to:a,data:this.encodeApprove(l,E),value:0n});this.log(`Approval tx sent: ${S}`),await this.waitForReceipt(r,S),this.log("Approval confirmed")}else this.log("Sufficient allowance, skipping approval");let i=new Uint8Array(16);(globalThis.crypto??(await import("crypto")).webcrypto).getRandomValues(i);let f=[...i].reduce((E,S)=>E*256n+BigInt(S),0n).toString(),g=new Uint8Array(32);(globalThis.crypto??(await import("crypto")).webcrypto).getRandomValues(g);let u="0x"+[...g].map(E=>E.toString(16).padStart(2,"0")).join(""),x=Math.floor(Date.now()/1e3)+(e.maxTimeoutSeconds||300),b=d?.eip712Domain,C=b?{name:b.name,version:b.version,chainId:BigInt(b.chainId),verifyingContract:b.verifyingContract}:{name:"DexterBSCFacilitator",version:"1",chainId:BigInt(this.getChainId(e.network)),verifyingContract:l},v=d?.eip712Types??{Payment:[{name:"from",type:"address"},{name:"to",type:"address"},{name:"token",type:"address"},{name:"amount",type:"uint256"},{name:"fee",type:"uint256"},{name:"nonce",type:"uint256"},{name:"deadline",type:"uint256"},{name:"paymentId",type:"bytes32"}]},X={from:t.address,to:o,token:a,amount:BigInt(c),fee:BigInt(p),nonce:BigInt(f),deadline:BigInt(x),paymentId:u},j=await t.signTypedData({domain:C,types:v,primaryType:"Payment",message:X});this.log("EIP-712 Payment signature obtained");let J={from:t.address,to:o,token:a,amount:c,fee:p,nonce:f,deadline:x,paymentId:u,signature:j};return{serialized:JSON.stringify(J),signature:j}}async buildPermit2Transaction(e,t,s){let{payTo:o,asset:a}=e,d=e.amount??e.maxAmountRequired;if(!d)throw new Error("Missing amount in payment requirements");if(!t.signTypedData)throw new Error("Wallet does not support signTypedData (EIP-712)");this.log("Building Permit2 transaction:",{from:t.address,to:o,amount:d,asset:a,network:e.network});let c=s||this.getDefaultRpcUrl(e.network),l=await this.readAllowance(c,a,t.address,ee),r;if(l<BigInt(d)){let C=this.encodeApprove(ee,at);if(t.signTransaction){this.log(`Signing Permit2 approval for relay (current allowance: ${l})`);let v=this.getChainId(e.network),X=await this.readGasPrice(c),j=await this.readNonce(c,t.address),J=await t.signTransaction({to:a,data:C,chainId:v,gas:50000n,gasPrice:X,nonce:j});r={erc20ApprovalGasSponsoring:{info:{from:t.address,asset:a,spender:ee,amount:at.toString(),signedTransaction:J,version:"1"}}},this.log("Permit2 approval signed for facilitator relay")}else if(t.sendTransaction){this.log(`Approving Permit2 directly (current allowance: ${l})`);let v=await t.sendTransaction({to:a,data:C,value:0n});this.log(`Permit2 approval tx sent: ${v}`),await this.waitForReceipt(c,v),this.log("Permit2 approval confirmed")}else throw new Error("Permit2 payments require a wallet that supports signTransaction or sendTransaction for the one-time Permit2 approval. Use createEvmKeypairWallet() or a browser wallet with transaction support.")}else this.log("Sufficient Permit2 allowance, skipping approval");let p=new Uint8Array(32);(globalThis.crypto??(await import("crypto")).webcrypto).getRandomValues(p);let y=[...p].reduce((C,v)=>C*256n+BigInt(v),0n),A=Math.floor(Date.now()/1e3),i=A-600,f=A+(e.maxTimeoutSeconds||300),g=this.getChainId(e.network),u={name:"Permit2",chainId:BigInt(g),verifyingContract:ee},_={permitted:{token:a,amount:BigInt(d)},spender:ve,nonce:y,deadline:BigInt(f),witness:{to:o,validAfter:BigInt(i)}},x=await t.signTypedData({domain:u,types:Pt,primaryType:"PermitWitnessTransferFrom",message:_});this.log("Permit2 PermitWitnessTransferFrom signature obtained");let b={signature:x,permit2Authorization:{from:t.address,permitted:{token:a,amount:d},spender:ve,nonce:y.toString(),deadline:String(f),witness:{to:o,validAfter:String(i)}}};return{serialized:JSON.stringify(b),signature:x,extensions:r}}async readAllowance(e,t,s,o){let a="0xdd62ed3e",d=s.slice(2).toLowerCase().padStart(64,"0"),c=o.slice(2).toLowerCase().padStart(64,"0"),l=a+d+c;try{let p=await(await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_call",params:[{to:t,data:l},"latest"]})})).json();return p.error||!p.result||p.result==="0x"?0n:BigInt(p.result)}catch{return 0n}}encodeApprove(e,t){let s="0x095ea7b3",o=e.slice(2).toLowerCase().padStart(64,"0"),a=t.toString(16).padStart(64,"0");return s+o+a}async waitForReceipt(e,t,s=3e4){let o=Date.now();for(;Date.now()-o<s;){try{let d=await(await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_getTransactionReceipt",params:[t]})})).json();if(d.result){if(d.result.status==="0x0")throw new Error(`Approval transaction reverted: ${t}`);return}}catch(a){if(a instanceof Error&&a.message.includes("reverted"))throw a}await new Promise(a=>setTimeout(a,2e3))}throw new Error(`Approval transaction receipt timeout after ${s}ms: ${t}`)}async readGasPrice(e){try{let s=await(await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_gasPrice",params:[]})})).json();return s.result?BigInt(s.result):50000000n}catch{return 50000000n}}async readNonce(e,t){try{let o=await(await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"eth_getTransactionCount",params:[t,"latest"]})})).json();return o.result?parseInt(o.result,16):0}catch{return 0}}calculateApprovalAmount(e,t,s){let o=BigInt(e)+BigInt(t);if(!s||s.mode==="exact")return o;let a=BigInt(s.defaultMultiple??10),d=o*a;if(s.maxCapUsd){let c=this.inferDecimals(e),l=BigInt(Math.floor(s.maxCapUsd*Math.pow(10,c)));if(d>l)return l}if(s.exactAboveUsd){let c=this.inferDecimals(e),l=BigInt(Math.floor(s.exactAboveUsd*Math.pow(10,c)));if(BigInt(e)>l)return o}return d}inferDecimals(e){return e.length>12?18:6}};function he(n){return new Fe(n)}function Ze(n){if(n===Ne||n===st)return!0;let e=n.toLowerCase();for(let t of Object.values($e))if(t.toLowerCase()===e)return!0;for(let t of Object.keys(Ke))if(t.toLowerCase()===e)return!0;return!1}function Ct(n){return{[Ee]:"Solana",[Me]:"Solana Devnet",[Le]:"Solana Testnet",solana:"Solana","solana-devnet":"Solana Devnet","solana-testnet":"Solana Testnet",[Z]:"Base",[ae]:"Base Sepolia",[me]:"Ethereum",[ie]:"Arbitrum",[ce]:"Polygon",[pe]:"Optimism",[le]:"Avalanche",[de]:"BSC",[ue]:"SKALE Base",[fe]:"SKALE Base Sepolia",base:"Base","base-sepolia":"Base Sepolia",ethereum:"Ethereum",arbitrum:"Arbitrum",polygon:"Polygon",optimism:"Optimism",avalanche:"Avalanche",bsc:"BSC","skale-base":"SKALE Base","skale-base-sepolia":"SKALE Base Sepolia"}[n]||n}function it(n,e){let t=Ct(n);return t===n?e:t}async function It(n,e){if(typeof n=="string")return[n,e];if(n instanceof URL)return[n.href,e];let t=n,s=new Headers(t.headers);e?.headers&&new Headers(e.headers).forEach((d,c)=>s.set(c,d));let o={method:e?.method??t.method,headers:s,signal:e?.signal??t.signal,redirect:e?.redirect??t.redirect,credentials:e?.credentials??t.credentials},a=(o.method??"GET").toUpperCase();return e&&"body"in e?o.body=e.body:a!=="GET"&&a!=="HEAD"&&t.body&&(o.body=await t.arrayBuffer()),[t.url,o]}var ct=new WeakMap;function je(n){return ct.get(n)}function Ve(n){let{adapters:e=[ge({verbose:n.verbose}),he({verbose:n.verbose})],wallets:t,wallet:s,preferredNetwork:o,rpcUrls:a={},maxAmountAtomic:d,fetch:c=globalThis.fetch,verbose:l=!1,accessPass:r,onPaymentRequired:p,maxRetries:y=0,retryDelayMs:A=500}=n,i=l?console.log.bind(console,"[x402]"):()=>{};async function f(E,S){let P;for(let w=0;w<=y;w++)try{let T=await c(E,S);if(T.status>=502&&T.status<=504&&w<y){i(`Retry ${w+1}/${y}: server returned ${T.status}`),await new Promise(I=>setTimeout(I,A*Math.pow(2,w)));continue}return T}catch(T){P=T,w<y&&(i(`Retry ${w+1}/${y}: ${T instanceof Error?T.message:"network error"}`),await new Promise(I=>setTimeout(I,A*Math.pow(2,w))))}throw P}let g=new Map;function u(E){try{let S=new URL(E).host,P=g.get(S);if(P&&P.expiresAt>Date.now()/1e3+10)return P.jwt;P&&g.delete(S)}catch{}return null}function _(E,S){try{let P=new URL(E).host,w=S.split(".");if(w.length===3){let T=JSON.parse(atob(w[1].replace(/-/g,"+").replace(/_/g,"/"))),I=Math.floor(Date.now()/1e3),B=I+86400,k=Math.min(typeof T.exp=="number"?T.exp:I,B);g.set(P,{jwt:S,expiresAt:k}),i("Access pass cached for",P,"| expires:",new Date(k*1e3).toISOString())}}catch{i("Failed to cache access pass")}}let x=t||{};s&&!x.solana&&ne(s)&&(x.solana=s),s&&!x.evm&&re(s)&&(x.evm=s);function b(E){let S=[];for(let P of E){let w=e.find(I=>I.canHandle(P.network));if(!w)continue;let T;w.name==="Solana"?T=x.solana:w.name==="EVM"&&(T=x.evm),T&&w.isConnected(T)&&S.push({accept:P,adapter:w,wallet:T})}if(S.length===0)return null;if(o){let P=S.find(w=>w.accept.network===o);if(P)return P}return S[0]}function C(E,S){return it(E,S)}function v(E,S){return a[E]||S.getDefaultRpcUrl(E)}async function X(E,S,P,w,T){let I="";if(r?.preferTier&&w.tiers){let m=w.tiers.find(K=>K.id===r.preferTier);if(m){if(r.maxSpend&&parseFloat(m.price)>parseFloat(r.maxSpend))throw new R("access_pass_exceeds_max_spend",`Access pass tier "${m.id}" costs $${m.price}, exceeds max spend $${r.maxSpend}`);I=`tier=${m.id}`}}else if(r?.preferDuration&&w.ratePerHour)I=`duration=${r.preferDuration}`;else if(w.tiers&&w.tiers.length>0){let m=w.tiers[0];if(r?.maxSpend&&parseFloat(m.price)>parseFloat(r.maxSpend))throw new R("access_pass_exceeds_max_spend",`Cheapest access pass costs $${m.price}, exceeds max spend $${r?.maxSpend}`);I=`tier=${m.id}`}let B=I?T.includes("?")?`${T}&${I}`:`${T}?${I}`:T;i("Purchasing access pass:",I||"default tier");let k=P.headers.get("PAYMENT-REQUIRED");if(!k)return null;let L;try{L=JSON.parse(atob(k))}catch{return null}let U=b(L.accepts);if(!U)return null;let{accept:N,adapter:$,wallet:ye}=U;if($.name==="Solana"&&!N.extra?.feePayer)return null;let Y=N.extra?.decimals??(Ze(N.asset)?6:void 0);if(typeof Y!="number")return null;let Ae=N.amount??N.maxAmountRequired;if(!Ae)return null;let z=v(N.network,$);try{let m=await $.getBalance(N,ye,z),K=Number(Ae)/Math.pow(10,Y);if(m<K){let At=C(N.network,$.name);throw new R("insufficient_balance",`Insufficient balance for access pass on ${At}. Have $${m.toFixed(4)}, need $${K.toFixed(4)}`)}}catch(m){if(m instanceof R)throw m}let V=await $.buildTransaction(N,ye,z),se;$.name==="EVM"?se=JSON.parse(V.serialized):se={transaction:V.serialized};let G=typeof E=="string"?E:E instanceof URL?E.href:E.url,oe=L.resource;if(typeof L.resource=="string")try{let m=new URL(L.resource,G);["http:","https:"].includes(m.protocol)&&(oe=m.toString())}catch{}else if(L.resource&&typeof L.resource=="object"&&"url"in L.resource){let m=L.resource;try{let K=new URL(m.url,G);["http:","https:"].includes(K.protocol)&&(oe={...m,url:K.toString()})}catch{}}let Oe={x402Version:N.x402Version??2,resource:oe,accepted:N,payload:se};V.extensions&&(Oe.extensions=V.extensions);let H=btoa(JSON.stringify(Oe)),Q=await c(B,{...S,method:"POST",headers:{...S?.headers||{},"Content-Type":"application/json","PAYMENT-SIGNATURE":H}});if(!Q.ok)return i("Pass purchase failed:",Q.status),null;let h=Q.headers.get("ACCESS-PASS");return h&&(_(T,h),i("Access pass purchased and cached")),Q}async function j(E,S){let P=E;if(i("Making request:",P),r){let h=u(P);if(h){i("Using cached access pass");let m=await c(E,{...S,headers:{...S?.headers||{},Authorization:`Bearer ${h}`}});if(m.status!==401&&m.status!==402)return m;i("Cached pass rejected (status",m.status,"), purchasing new pass");try{g.delete(new URL(P).host)}catch{}}}let w=await f(E,S);if(w.status!==402)return w;i("Received 402 Payment Required");let T=w.headers.get("X-ACCESS-PASS-TIERS");if(r&&T){i("Server offers access passes, purchasing...");try{let h=JSON.parse(atob(T)),m=await X(E,S,w,h,P);if(m)return m}catch(h){i("Access pass purchase failed, falling back to per-request payment:",h)}}let I=w.headers.get("PAYMENT-REQUIRED");if(!I)throw new R("missing_payment_required_header","Server returned 402 but no PAYMENT-REQUIRED header");let B;try{let h=atob(I);B=JSON.parse(h)}catch{throw new R("invalid_payment_required","Failed to decode PAYMENT-REQUIRED header")}i("Payment requirements:",B);let k=w.headers.get("X-Quote-Hash");k&&i("Quote hash received:",k);let L=b(B.accepts);if(!L){let h=B.accepts.map(m=>m.network).join(", ");throw new R("no_matching_payment_option",`No connected wallet for any available network: ${h}`)}let{accept:U,adapter:N,wallet:$}=L;if(i(`Using ${N.name} for ${U.network}`),N.name==="Solana"&&!U.extra?.feePayer)throw new R("missing_fee_payer","Solana payment option missing feePayer in extra");let ye=U.extra?.decimals??(Ze(U.asset)?6:void 0);if(typeof ye!="number")throw new R("missing_decimals","Payment option missing decimals - provide in extra or use a known stablecoin");let Y=U.amount??U.maxAmountRequired;if(!Y)throw new R("missing_amount","Payment option missing amount");if(d&&BigInt(Y)>BigInt(d))throw new R("amount_exceeds_max",`Payment amount ${Y} exceeds maximum ${d}`);let Ae=v(U.network,N);i("Checking balance...");try{let h=await N.getBalance(U,$,Ae),m=Number(Y)/Math.pow(10,ye);if(h<m){let K=C(U.network,N.name);throw new R("insufficient_balance",`Insufficient balance on ${K}. Have $${h.toFixed(4)}, need $${m.toFixed(4)}`)}i(`Balance OK: $${h.toFixed(4)} >= $${m.toFixed(4)}`)}catch(h){if(h instanceof R)throw h;i("Balance check failed (RPC error), proceeding with transaction attempt")}if(p&&!await p(U))throw new R("payment_rejected","Payment rejected by onPaymentRequired callback");i("Building transaction...");let z=await N.buildTransaction(U,$,Ae);i("Transaction signed");let V;N.name==="EVM"?V=JSON.parse(z.serialized):V={transaction:z.serialized};let se=E,G=B.resource;if(typeof B.resource=="string")try{let h=new URL(B.resource,se).toString();h!==B.resource&&i("Resolved relative resource URL:",B.resource,"\u2192",h),G=h}catch{G=B.resource}else if(B.resource&&typeof B.resource=="object"&&"url"in B.resource){let h=B.resource;try{let m=new URL(h.url,se).toString();m!==h.url&&(i("Resolved relative resource URL:",h.url,"\u2192",m),G={...h,url:m})}catch{}}let oe={x402Version:U.x402Version??2,resource:G,accepted:U,payload:V};z.extensions&&(oe.extensions=z.extensions);let Oe=btoa(JSON.stringify(oe));i("Retrying request with payment...");let H=await f(E,{...S,headers:{...S?.headers||{},"PAYMENT-SIGNATURE":Oe,...k?{"X-Quote-Hash":k}:{}}});if(i("Retry response status:",H.status),H.status===402){let h="unknown";try{let m=await H.clone().json();h=String(m.error||m.message||JSON.stringify(m)),i("Rejection reason:",h)}catch{}throw new R("payment_rejected",`Payment was rejected by the server: ${h}`)}let Q=H.headers.get("PAYMENT-RESPONSE");if(Q)try{let h=JSON.parse(atob(Q));ct.set(H,h),h.extensions&&i("Settlement extensions:",Object.keys(h.extensions).join(", "))}catch{}return H}async function J(E,S){let[P,w]=await It(E,S);return j(P,w)}return{fetch:J}}var W=require("@solana/web3.js"),Be=Symbol.for("x402:keypair");async function He(n){let e;if(typeof n=="string"){let t;try{let s=await Promise.resolve().then(()=>(ut(),dt)),o=s.decode??s.default?.decode;if(!o)throw new Error("decode not found");t=o}catch{throw new Error('The "bs58" package is required for base58 private keys. Install it with: npm install bs58')}try{let s=t(n);e=W.Keypair.fromSecretKey(s)}catch{try{let o=JSON.parse(n);if(Array.isArray(o))e=W.Keypair.fromSecretKey(Uint8Array.from(o));else throw new Error("Invalid private key format")}catch{throw new Error("Invalid private key. Expected base58 string or JSON array of bytes.")}}}else if(Array.isArray(n))e=W.Keypair.fromSecretKey(Uint8Array.from(n));else if(n instanceof Uint8Array)e=W.Keypair.fromSecretKey(n);else throw new Error("Invalid private key type. Expected string, number[], or Uint8Array.");return{publicKey:{toBase58:()=>e.publicKey.toBase58()},signTransaction:async t=>{if(t instanceof W.VersionedTransaction)return t.sign([e]),t;if(t instanceof W.Transaction)return t.sign(e),t;throw new Error("Unknown transaction type")},[Be]:e}}function ft(n){if(!n||typeof n!="object")return!1;let e=n;return Be in e&&e[Be]instanceof W.Keypair&&"publicKey"in e&&"signTransaction"in e}async function Xe(n){let e;try{e=(await import("viem/accounts")).privateKeyToAccount}catch{throw new Error("EVM wallet support requires viem as a peer dependency. Install with: npm install viem")}let t=n.startsWith("0x")?n:`0x${n}`,s=e(t);return{address:s.address,signTypedData:o=>s.signTypedData(o),signTransaction:o=>s.signTransaction({to:o.to,data:o.data,chainId:o.chainId,gas:o.gas,gasPrice:o.gasPrice,nonce:o.nonce,type:"legacy"})}}function mt(n){if(!n||typeof n!="object")return!1;let e=n;return"address"in e&&typeof e.address=="string"&&e.address.startsWith("0x")&&"signTypedData"in e&&typeof e.signTypedData=="function"}function Je(n,e){let{walletPrivateKey:t,evmPrivateKey:s,preferredNetwork:o,rpcUrls:a,maxAmountAtomic:d,verbose:c,accessPass:l,onPaymentRequired:r}=e;if(!t&&!s)throw new Error("At least one wallet private key is required (walletPrivateKey or evmPrivateKey)");let p={},y=[];t&&y.push(He(t).then(u=>{p.solana=u}).catch(u=>{console.warn(`[x402] Solana wallet init failed: ${u.message}`)})),s&&y.push(Xe(s).then(u=>{p.evm=u}).catch(u=>{console.warn(`[x402] EVM wallet init failed: ${u.message}`)}));let A=y.length>0?Promise.all(y):null,f=Ve({wallets:p,preferredNetwork:o,rpcUrls:a,maxAmountAtomic:d,fetch:n,verbose:c,accessPass:l,onPaymentRequired:r}),g=f.fetch.bind(f);return A?(async(u,_)=>(await A,g(u,_))):g}var et=require("@dexterai/x402-core");function gt(n){let{budget:e,allowedDomains:t,onPaymentRequired:s,...o}=n,a=parseFloat(e.total),d=e.perRequest?parseFloat(e.perRequest):1/0,c=e.perHour?parseFloat(e.perHour):1/0;if(isNaN(a)||a<=0)throw new Error("budget.total must be a positive number");let l=[],r=0;function p(){return l.reduce((f,g)=>f+g.amount,0)}function y(){let f=Date.now()-36e5;return l.filter(g=>g.timestamp>=f).reduce((g,u)=>g+u.amount,0)}let A=Je(fetch,{...o,onPaymentRequired:async f=>{let g=f.extra?.decimals??6,u=Number(f.amount)/Math.pow(10,g);if(u>d)throw new R("amount_exceeds_max",`$${u.toFixed(4)} exceeds per-request limit of $${d.toFixed(2)}`);let _=p();if(_+u>a)throw new R("amount_exceeds_max",`Budget exceeded. Spent $${_.toFixed(2)} of $${a.toFixed(2)}, payment: $${u.toFixed(4)}`);let x=y();if(x+u>c)throw new R("amount_exceeds_max",`Hourly limit ($${c.toFixed(2)}) exceeded. Spent $${x.toFixed(2)} this hour`);return r=u,s?s(f):!0}});return{fetch:(async(f,g)=>{let u=typeof f=="string"?f:f instanceof URL?f.href:f.url,_="unknown";try{_=new URL(u).hostname}catch{}if(t&&!t.some(b=>_===b||_.endsWith(`.${b}`)))throw new R("payment_rejected",`Domain "${_}" not in allowed domains`);r=0;let x=await A(f,g);if(r>0){let b="unknown",C=x.headers.get("PAYMENT-RESPONSE");if(C)try{b=JSON.parse(atob(C)).network||b}catch{}l.push({amount:r,domain:_,network:b,timestamp:Date.now()}),r=0}return x}),get spent(){return`$${p().toFixed(2)}`},get remaining(){return`$${(a-p()).toFixed(2)}`},get payments(){return l.length},get spentAmount(){return p()},get remainingAmount(){return a-p()},get ledger(){return l},get hourlySpend(){return y()},reset(){l=[]}}}function Ye(n){let e=je(n);if(e?.extensions?.["sponsored-access"])return e.extensions["sponsored-access"]}function ht(n){let e=Ye(n);if(e?.recommendations?.length)return e.recommendations}async function yt(n){let t=Ye(n)?.tracking?.impressionBeacon;if(!t)return!1;try{await fetch(t,{method:"GET"})}catch{}return!0}0&&(module.exports={BASE_MAINNET,DEXTER_FACILITATOR_URL,KEYPAIR_SYMBOL,SOLANA_MAINNET,USDC_MINT,X402Error,capabilitySearch,createBudgetAccount,createEvmAdapter,createEvmKeypairWallet,createKeypairWallet,createSolanaAdapter,createX402Client,fireImpressionBeacon,getPaymentReceipt,getSponsoredAccessInfo,getSponsoredRecommendations,isEvmKeypairWallet,isKeypairWallet,wrapFetch});
|
package/dist/client/index.d.cts
CHANGED
|
@@ -1,9 +1,7 @@
|
|
|
1
|
-
export { P as PaymentReceipt, a as X402Client, X as X402ClientConfig, c as createX402Client, f as fireImpressionBeacon, g as getPaymentReceipt, d as getSponsoredAccessInfo, b as getSponsoredRecommendations } from '../sponsored-access-
|
|
2
|
-
import { A as AccessPassClientConfig, P as PaymentAccept } from '../types-
|
|
3
|
-
export {
|
|
1
|
+
export { P as PaymentReceipt, a as X402Client, X as X402ClientConfig, c as createX402Client, f as fireImpressionBeacon, g as getPaymentReceipt, d as getSponsoredAccessInfo, b as getSponsoredRecommendations } from '../sponsored-access-B2UCVgj3.cjs';
|
|
2
|
+
import { A as AccessPassClientConfig, P as PaymentAccept, S as SolanaWallet, E as EvmWallet } from '../types-IqnDBsjL.cjs';
|
|
3
|
+
export { d as AccessPassInfo, b as AccessPassTier, C as ChainAdapter, W as WalletSet, X as X402Error, a as createEvmAdapter, c as createSolanaAdapter } from '../types-IqnDBsjL.cjs';
|
|
4
4
|
import { Keypair } from '@solana/web3.js';
|
|
5
|
-
import { S as SolanaWallet, E as EvmWallet } from '../types-i7C2GiVY.cjs';
|
|
6
|
-
export { C as ChainAdapter, W as WalletSet, a as createEvmAdapter, c as createSolanaAdapter } from '../types-i7C2GiVY.cjs';
|
|
7
5
|
export { FormattedResource as CapabilityAPI, CapabilitySearchOptions, CapabilitySearchResult, NoMatchReason, capabilitySearch } from '@dexterai/x402-core';
|
|
8
6
|
export { B as BASE_MAINNET, D as DEXTER_FACILITATOR_URL, S as SOLANA_MAINNET, U as USDC_MINT } from '../constants-qU-4U3L-.cjs';
|
|
9
7
|
export { SponsoredAccessSettlementInfo, SponsoredRecommendation } from '@dexterai/x402-ads-types';
|
package/dist/client/index.d.ts
CHANGED
|
@@ -1,9 +1,7 @@
|
|
|
1
|
-
export { P as PaymentReceipt, a as X402Client, X as X402ClientConfig, c as createX402Client, f as fireImpressionBeacon, g as getPaymentReceipt, d as getSponsoredAccessInfo, b as getSponsoredRecommendations } from '../sponsored-access-
|
|
2
|
-
import { A as AccessPassClientConfig, P as PaymentAccept } from '../types-
|
|
3
|
-
export {
|
|
1
|
+
export { P as PaymentReceipt, a as X402Client, X as X402ClientConfig, c as createX402Client, f as fireImpressionBeacon, g as getPaymentReceipt, d as getSponsoredAccessInfo, b as getSponsoredRecommendations } from '../sponsored-access-B2USBiVp.js';
|
|
2
|
+
import { A as AccessPassClientConfig, P as PaymentAccept, S as SolanaWallet, E as EvmWallet } from '../types-IqnDBsjL.js';
|
|
3
|
+
export { d as AccessPassInfo, b as AccessPassTier, C as ChainAdapter, W as WalletSet, X as X402Error, a as createEvmAdapter, c as createSolanaAdapter } from '../types-IqnDBsjL.js';
|
|
4
4
|
import { Keypair } from '@solana/web3.js';
|
|
5
|
-
import { S as SolanaWallet, E as EvmWallet } from '../types-BPKUVJEl.js';
|
|
6
|
-
export { C as ChainAdapter, W as WalletSet, a as createEvmAdapter, c as createSolanaAdapter } from '../types-BPKUVJEl.js';
|
|
7
5
|
export { FormattedResource as CapabilityAPI, CapabilitySearchOptions, CapabilitySearchResult, NoMatchReason, capabilitySearch } from '@dexterai/x402-core';
|
|
8
6
|
export { B as BASE_MAINNET, D as DEXTER_FACILITATOR_URL, S as SOLANA_MAINNET, U as USDC_MINT } from '../constants-qU-4U3L-.js';
|
|
9
7
|
export { SponsoredAccessSettlementInfo, SponsoredRecommendation } from '@dexterai/x402-ads-types';
|