@onchaindb/sdk 2.1.1 → 4.0.0

package/src/types.ts

@@ -1,6 +1,6 @@
 // Core OnDB Types
 import {QueryValue} from "./query-sdk";
-import {X402Quote} from "./x402/types";
+import {X402PaymentRequiredResponse} from "./x402/types";
 
 export interface OnDBConfig {
     endpoint: string;
@@ -182,10 +182,10 @@ export interface ReadQueryWithPayment {
     quote_id: string;
 }
 
-// Union type for query responses - either data or quote
+// Union type for query responses - either data or payment required
 export type QueryResult<T extends Record<string, any>> =
-    | QueryResponse<T>  // Normal response with data
-    | X402Quote;        // Quote response when payment required (x402 format)
+    | QueryResponse<T>              // Normal response with data
+    | X402PaymentRequiredResponse;  // Raw 402 response when payment required
 
 // Transaction Events
 export interface TransactionEvents {
@@ -230,7 +230,7 @@ export class ValidationError extends OnDBError {
 export class PaymentRequiredError extends OnDBError {
     constructor(
         message: string,
-        public quote: X402Quote,
+        public paymentRequired: X402PaymentRequiredResponse,
         details?: any
     ) {
         super(message, 'PAYMENT_REQUIRED', 402, details);

package/src/x402/types.ts

@@ -42,6 +42,21 @@ export interface X402PaymentRequirement {
     mimeType: string;
     /** Maximum timeout for payment in seconds */
     maxTimeoutSeconds: number;
+    /** Token decimals (e.g. 6 for TIA/USDC) */
+    tokenDecimals: number;
+    /** Token symbol (e.g. "TIA", "USDC") */
+    tokenSymbol: string;
+    /** Token name (e.g. "Celestia") */
+    tokenName: string;
+    /** Token version string */
+    tokenVersion: string;
+    /** Token metadata object */
+    tokenMetadata: {
+        decimals: number;
+        name: string;
+        symbol: string;
+        version: string;
+    };
     /** Extra extension data */
     extra?: X402Extra;
 }
@@ -50,6 +65,10 @@ export interface X402PaymentRequirement {
  * x402 Extra field with OnDB extensions
  */
 export interface X402Extra {
+    /** Extension name */
+    name?: string;
+    /** Extension version */
+    version?: string;
     /** Extension identifier */
     x402Extension?: string;
     /** Quote ID for this payment */
@@ -62,10 +81,6 @@ export interface X402Extra {
     paymentMethod?: PaymentMethod;
     /** x402 facilitator URL */
     facilitator?: string;
-    /** Token symbol */
-    tokenSymbol?: string;
-    /** Token decimals */
-    tokenDecimals?: number;
     /** Cost breakdown */
     costBreakdown?: Record<string, number>;
     /** Pricing information */
@@ -73,6 +88,8 @@ export interface X402Extra {
         baseAmount: string;
         baseAsset: string;
         premiumPercent?: number;
+        note?: string;
+        payoutSlippagePercent?: number;
         expiresAt?: number;
     };
 }
@@ -123,13 +140,13 @@ export interface X402NativePayload {
 export interface X402EvmPayload {
     /** EIP-712 signature */
     signature: string;
-    /** ERC-3009 authorization */
+    /** ERC-3009 authorization — validAfter/validBefore must be decimal strings (uint256) */
     authorization: {
         from: string;
         to: string;
         value: string;
-        validAfter: number;
-        validBefore: number;
+        validAfter: string;
+        validBefore: string;
         nonce: string;
     };
 }
@@ -226,8 +243,8 @@ export interface X402FacilitatorPaymentResult {
             from: string;
             to: string;
             value: string;
-            validAfter: number;
-            validBefore: number;
+            validAfter: string;
+            validBefore: string;
             nonce: string;
         };
     };

package/src/x402/utils.ts

@@ -55,6 +55,16 @@ function parsePaymentRequirement(req: any): X402PaymentRequirement {
         description: req.description,
         mimeType: req.mimeType || 'application/json',
         maxTimeoutSeconds: req.maxTimeoutSeconds || 300,
+        tokenDecimals: req.tokenDecimals ?? 6,
+        tokenSymbol: req.tokenSymbol ?? '',
+        tokenName: req.tokenName ?? '',
+        tokenVersion: req.tokenVersion ?? '',
+        tokenMetadata: req.tokenMetadata ?? {
+            decimals: req.tokenDecimals ?? 6,
+            name: req.tokenName ?? '',
+            symbol: req.tokenSymbol ?? '',
+            version: req.tokenVersion ?? '',
+        },
         extra: req.extra,
     };
 }
@@ -80,7 +90,7 @@ export function requirementToQuote(
     }
 
     // Calculate total cost (for display purposes)
-    const decimals = extra.tokenDecimals || 6;
+    const decimals = requirement.tokenDecimals ?? 6;
     const totalCost = parseInt(amountRaw) / Math.pow(10, decimals);
 
     // Calculate expiration
@@ -97,7 +107,7 @@ export function requirementToQuote(
         chainType,
         network: requirement.network,
         asset: requirement.asset,
-        tokenSymbol: extra.tokenSymbol || getTokenSymbol(requirement.asset),
+        tokenSymbol: requirement.tokenSymbol || getTokenSymbol(requirement.asset),
         tokenDecimals: decimals,
         paymentMethod: (extra.paymentMethod || 'native') as PaymentMethod,
         facilitator: extra.facilitator,
@@ -176,8 +186,8 @@ export interface EvmFacilitatorAuthorization {
         from: string;
         to: string;
         value: string;
-        validAfter: number;
-        validBefore: number;
+        validAfter: string;
+        validBefore: string;
         nonce: string;
     };
 }