@ziongateway/sdk 0.1.4 → 0.1.5

package/dist/ZionAgent.d.ts

@@ -34,6 +34,13 @@ export interface ZionAgentConfig {
      * @default false
      */
     debug?: boolean;
+    /**
+     * Optional Kora configuration for gasless transactions.
+     * If not provided, Zion SDK will automatically use default Kora URLs based on network.
+     */
+    koraConfig?: {
+        rpcUrl: string;
+    };
 }
 /**
  * Options for the fetch request (similar to standard fetch options).
@@ -115,6 +122,7 @@ export declare class ZionAgent {
     private connection;
     private network;
     private debug;
+    private koraClient?;
     /**
      * Create a new ZionAgent instance.
      *
@@ -165,7 +173,11 @@ export declare class ZionAgent {
      */
     private parsePaymentRequirements;
     /**
-     * Execute the payment transaction.
+     * Execute Gasless Payment (Kora)
+     */
+    private executeGaslessPayment;
+    /**
+     * Execute the payment transaction (Standard SOL Gas).
      */
     private executePayment;
     /**

package/dist/ZionAgent.js

@@ -9,6 +9,7 @@ const spl_token_1 = require("@solana/spl-token");
 const bs58_1 = __importDefault(require("bs58"));
 const index_1 = require("./index");
 const Universal_1 = require("./Universal");
+const kora_1 = require("@solana/kora");
 /**
  * Custom error class for ZionAgent payment errors.
  */
@@ -69,6 +70,26 @@ class ZionAgent {
             : "https://api.mainnet-beta.solana.com";
         this.connection = new web3_js_1.Connection(config.rpcUrl || defaultRpc, "confirmed");
         this.debug = config.debug || false;
+        // Kora Configuration (Automatic)
+        let koraUrl = config.koraConfig?.rpcUrl;
+        // Auto-configure Kora URL if not provided
+        if (!koraUrl) {
+            if (this.network === "solana-devnet") {
+                koraUrl = "https://api.devnet.solana.com";
+            }
+            else {
+                koraUrl = "https://zion-kora-server-production.up.railway.app";
+            }
+        }
+        if (this.debug)
+            console.log(`[ZionAgent] Using Kora URL: ${koraUrl}`);
+        try {
+            this.koraClient = new kora_1.KoraClient({ rpcUrl: koraUrl });
+        }
+        catch (e) {
+            if (this.debug)
+                console.warn("[ZionAgent] Kora initialization failed, falling back to standard transactions", e);
+        }
         if (this.debug) {
             console.log(`[ZionAgent] Initialized with wallet: ${this.wallet.publicKey.toBase58()}`);
             console.log(`[ZionAgent] Network: ${this.network}`);
@@ -150,7 +171,30 @@ class ZionAgent {
             console.log(`[ZionAgent] Payment requirements:`, requirements);
         }
         // Execute payment
-        const { signature, paymentHeader } = await this.executePayment(requirements);
+        let signature;
+        let paymentHeader;
+        try {
+            // Attempt Gasless with Kora first
+            if (this.koraClient) {
+                const result = await this.executeGaslessPayment(requirements);
+                signature = result.signature;
+                paymentHeader = result.paymentHeader;
+            }
+            else {
+                // Fallback to standard
+                const result = await this.executePayment(requirements);
+                signature = result.signature;
+                paymentHeader = result.paymentHeader;
+            }
+        }
+        catch (err) {
+            if (this.debug)
+                console.warn("[ZionAgent] Gasless Payment failed, attempting fallback to standard", err);
+            // Fallback to standard transaction if gasless fails
+            const result = await this.executePayment(requirements);
+            signature = result.signature;
+            paymentHeader = result.paymentHeader;
+        }
         if (this.debug) {
             console.log(`[ZionAgent] Payment successful! Signature: ${signature}`);
         }
@@ -198,7 +242,71 @@ class ZionAgent {
         };
     }
     /**
-     * Execute the payment transaction.
+     * Execute Gasless Payment (Kora)
+     */
+    async executeGaslessPayment(requirements) {
+        if (!this.koraClient)
+            throw new Error("Kora client not initialized");
+        if (this.debug)
+            console.log("[ZionAgent] Attempting Gasless Transaction via Kora...");
+        const assetMint = new web3_js_1.PublicKey(requirements.asset);
+        // 1. Get payer signer from Kora (this is the account paying gas)
+        // Note: getPayerSigner returns public keys, we just need the address to set as fee payer
+        const { signer_address: feePayerAddress } = await this.koraClient.getPayerSigner();
+        const feePayer = new web3_js_1.PublicKey(feePayerAddress);
+        // 2. Build instructions
+        const instructions = await index_1.PaymentBuilder.createAtomicSplitInstructions({
+            sender: this.wallet.publicKey.toBase58(),
+            recipient: requirements.recipient,
+            treasury: requirements.treasury,
+            amount: requirements.amount,
+            asset: requirements.asset,
+            connection: this.connection // Uses main RPC for looking up ATAs
+        });
+        // 3. Build Transaction
+        const { blockhash } = await this.connection.getLatestBlockhash();
+        const tx = new web3_js_1.Transaction();
+        tx.recentBlockhash = blockhash;
+        tx.feePayer = feePayer;
+        tx.add(...instructions);
+        // 4. Sign (Partial) - Only user signs, Kora will sign later
+        tx.partialSign(this.wallet);
+        // 5. Serialize
+        // requireAllSignatures: false because Kora's signature is missing
+        const serializedTx = tx.serialize({ requireAllSignatures: false });
+        const base64Tx = serializedTx.toString("base64");
+        // 6. Send to Kora
+        const response = await this.koraClient.signAndSendTransaction({
+            transaction: base64Tx
+        });
+        let signature = response.signature;
+        // Fallback: If signature is missing (some Kora versions), extract from signed_transaction
+        if (!signature && response.signed_transaction) {
+            const signedTxBuf = Buffer.from(response.signed_transaction, "base64");
+            const signedTx = web3_js_1.Transaction.from(signedTxBuf);
+            if (signedTx.signature) {
+                signature = bs58_1.default.encode(signedTx.signature);
+            }
+        }
+        if (this.debug)
+            console.log(`[ZionAgent] Kora Transaction Sent: ${signature}`);
+        // Kora usually waits for confirmation, but we can double check
+        await this.connection.confirmTransaction(signature, "confirmed");
+        // Create header (Standard x402 header)
+        const paymentHeader = index_1.PaymentBuilder.createHeader({
+            signature,
+            sender: this.wallet.publicKey.toBase58(),
+            recipient: requirements.recipient,
+            amount: requirements.amount,
+            asset: requirements.asset,
+            timestamp: Math.floor(Date.now() / 1000),
+            nonce: this.generateNonce(),
+            network: requirements.network || this.network
+        });
+        return { signature, paymentHeader };
+    }
+    /**
+     * Execute the payment transaction (Standard SOL Gas).
      */
     async executePayment(requirements) {
         const assetMint = new web3_js_1.PublicKey(requirements.asset);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziongateway/sdk",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "TypeScript SDK for Zion x402 Facilitator",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,6 +21,7 @@
   "author": "Zion",
   "license": "ISC",
   "dependencies": {
+    "@solana/kora": "^0.1.1",
     "@solana/spl-token": "^0.4.14",
     "@solana/web3.js": "^1.98.4",
     "axios": "^1.6.0",