@axonfi/sdk 0.9.0 → 0.10.0

package/dist/index.d.cts

@@ -579,10 +579,6 @@ interface ExecuteInput {
     deadline?: bigint;
     /** Arbitrary metadata stored off-chain. */
     metadata?: Record<string, string>;
-    /** Source token for pre-swap — an address, Token enum, or bare symbol string. */
-    fromToken?: TokenInput;
-    /** Max input for pre-swap: bigint (raw), number (human), or string (human). */
-    maxFromAmount?: AmountInput;
 }
 /**
  * Input for AxonClient.swap(). Signs a SwapIntent and submits to
@@ -620,6 +616,13 @@ interface PaymentResult {
     estimatedResolutionMs?: number;
     /** Rejection reason. Present when status === 'rejected'. */
     reason?: string;
+    /**
+     * Machine-readable error code. Present when status === 'rejected'.
+     * Notable values:
+     * - `'SWAP_REQUIRED'` — vault lacks the payment token. The SDK auto-handles
+     *   this by signing a SwapIntent and resubmitting.
+     */
+    errorCode?: string;
 }
 /** High-level vault info returned by AxonClient.getVaultInfo(). */
 interface VaultInfo {
@@ -797,6 +800,10 @@ declare class AxonClient {
      * - `"approved"`: fast path — txHash available immediately
      * - `"pending_review"`: AI scan or human review in progress — poll for status
      * - `"rejected"`: payment was rejected — reason field explains why
+     *
+     * If the vault doesn't hold enough of the payment token, the relayer returns
+     * `errorCode: 'SWAP_REQUIRED'`. The SDK automatically signs a SwapIntent and
+     * resubmits the payment with swap fields — no action needed from the caller.
      */
     pay(input: PayInput): Promise<PaymentResult>;
     /**
@@ -938,6 +945,7 @@ declare class AxonClient {
     private _buildPaymentIntent;
     private _buildExecuteIntent;
     private _buildSwapIntent;
+    private _submitPaymentWithSwap;
     private _submitPayment;
     private _submitExecute;
     private _submitSwap;

package/dist/index.d.ts

@@ -579,10 +579,6 @@ interface ExecuteInput {
     deadline?: bigint;
     /** Arbitrary metadata stored off-chain. */
     metadata?: Record<string, string>;
-    /** Source token for pre-swap — an address, Token enum, or bare symbol string. */
-    fromToken?: TokenInput;
-    /** Max input for pre-swap: bigint (raw), number (human), or string (human). */
-    maxFromAmount?: AmountInput;
 }
 /**
  * Input for AxonClient.swap(). Signs a SwapIntent and submits to
@@ -620,6 +616,13 @@ interface PaymentResult {
     estimatedResolutionMs?: number;
     /** Rejection reason. Present when status === 'rejected'. */
     reason?: string;
+    /**
+     * Machine-readable error code. Present when status === 'rejected'.
+     * Notable values:
+     * - `'SWAP_REQUIRED'` — vault lacks the payment token. The SDK auto-handles
+     *   this by signing a SwapIntent and resubmitting.
+     */
+    errorCode?: string;
 }
 /** High-level vault info returned by AxonClient.getVaultInfo(). */
 interface VaultInfo {
@@ -797,6 +800,10 @@ declare class AxonClient {
      * - `"approved"`: fast path — txHash available immediately
      * - `"pending_review"`: AI scan or human review in progress — poll for status
      * - `"rejected"`: payment was rejected — reason field explains why
+     *
+     * If the vault doesn't hold enough of the payment token, the relayer returns
+     * `errorCode: 'SWAP_REQUIRED'`. The SDK automatically signs a SwapIntent and
+     * resubmits the payment with swap fields — no action needed from the caller.
      */
     pay(input: PayInput): Promise<PaymentResult>;
     /**
@@ -938,6 +945,7 @@ declare class AxonClient {
     private _buildPaymentIntent;
     private _buildExecuteIntent;
     private _buildSwapIntent;
+    private _submitPaymentWithSwap;
     private _submitPayment;
     private _submitExecute;
     private _submitSwap;

package/dist/index.js

@@ -3973,11 +3973,30 @@ var AxonClient = class {
    * - `"approved"`: fast path — txHash available immediately
    * - `"pending_review"`: AI scan or human review in progress — poll for status
    * - `"rejected"`: payment was rejected — reason field explains why
+   *
+   * If the vault doesn't hold enough of the payment token, the relayer returns
+   * `errorCode: 'SWAP_REQUIRED'`. The SDK automatically signs a SwapIntent and
+   * resubmits the payment with swap fields — no action needed from the caller.
    */
   async pay(input) {
     const intent = this._buildPaymentIntent(input);
     const signature = await signPayment(this.walletClient, this.vaultAddress, this.chainId, intent);
-    return this._submitPayment(intent, signature, input);
+    const result = await this._submitPayment(intent, signature, input);
+    if (result.status === "rejected" && result.errorCode === "SWAP_REQUIRED") {
+      const swapIntent = {
+        bot: this.botAddress,
+        toToken: intent.token,
+        // swap TO the payment token
+        minToAmount: intent.amount,
+        // need at least the payment amount
+        deadline: intent.deadline,
+        // same deadline
+        ref: intent.ref
+      };
+      const swapSig = await signSwapIntent(this.walletClient, this.vaultAddress, this.chainId, swapIntent);
+      return this._submitPaymentWithSwap(intent, signature, input, swapIntent, swapSig);
+    }
+    return result;
   }
   // ============================================================================
   // execute()
@@ -4250,6 +4269,38 @@ Timestamp: ${timestamp}`;
       ref: this._resolveRef(input.memo, input.ref)
     };
   }
+  async _submitPaymentWithSwap(intent, signature, input, swapIntent, swapSignature) {
+    const idempotencyKey = generateUuid();
+    const body = {
+      // Routing
+      chainId: this.chainId,
+      vaultAddress: this.vaultAddress,
+      // Flat intent fields (matches relayer DTO)
+      bot: intent.bot,
+      to: intent.to,
+      token: intent.token,
+      amount: intent.amount.toString(),
+      deadline: intent.deadline.toString(),
+      ref: intent.ref,
+      signature,
+      // Swap fields
+      swapSignature,
+      swapToToken: swapIntent.toToken,
+      swapMinToAmount: swapIntent.minToAmount.toString(),
+      swapDeadline: swapIntent.deadline.toString(),
+      swapRef: swapIntent.ref,
+      // Off-chain metadata
+      idempotencyKey,
+      ...input.memo !== void 0 && { memo: input.memo },
+      ...input.resourceUrl !== void 0 && { resourceUrl: input.resourceUrl },
+      ...input.invoiceId !== void 0 && { invoiceId: input.invoiceId },
+      ...input.orderId !== void 0 && { orderId: input.orderId },
+      ...input.recipientLabel !== void 0 && { recipientLabel: input.recipientLabel },
+      ...input.metadata !== void 0 && { metadata: input.metadata },
+      ...input.x402Funding !== void 0 && { x402Funding: input.x402Funding }
+    };
+    return this._post(RELAYER_API.PAYMENTS, idempotencyKey, body);
+  }
   async _submitPayment(intent, signature, input) {
     const idempotencyKey = input.idempotencyKey ?? generateUuid();
     const body = {
@@ -4278,8 +4329,6 @@ Timestamp: ${timestamp}`;
   }
   async _submitExecute(intent, signature, input) {
     const idempotencyKey = input.idempotencyKey ?? generateUuid();
-    const fromToken = input.fromToken !== void 0 ? resolveToken(input.fromToken, this.chainId) : void 0;
-    const maxFromAmount = input.maxFromAmount !== void 0 ? parseAmount(input.maxFromAmount, input.fromToken ?? input.tokens?.[0] ?? "USDC", this.chainId) : void 0;
     const body = {
       chainId: this.chainId,
       vaultAddress: this.vaultAddress,
@@ -4295,9 +4344,6 @@ Timestamp: ${timestamp}`;
       signature,
       // Protocol calldata
       callData: input.callData,
-      // Optional pre-swap
-      ...fromToken !== void 0 && { fromToken },
-      ...maxFromAmount !== void 0 && { maxFromAmount: maxFromAmount.toString() },
       // Off-chain metadata
       idempotencyKey,
       ...input.memo !== void 0 && { memo: input.memo },