@kynesyslabs/demosdk 2.3.16 → 2.3.17

package/build/bridge/nativeBridge.d.ts

@@ -1,6 +1,7 @@
 import { BridgeOperationCompiled, SupportedChain, SupportedEVMChain, SupportedStablecoin, SupportedNonEVMChain } from "./nativeBridgeTypes";
 import { Transaction } from "../types/blockchain/Transaction";
 import { RPCRequest } from "../types";
+import { Demos } from "../websdk";
 export declare const methods: {
     /**
      * Validates the chain
@@ -16,11 +17,11 @@ export declare const methods: {
      */
     generateOperation(privateKey: string, publicKey: string, originChainType: SupportedChain, originChain: SupportedEVMChain | SupportedNonEVMChain, destinationChainType: SupportedChain, destinationChain: SupportedEVMChain | SupportedNonEVMChain, originAddress: string, destinationAddress: string, amount: string, token: SupportedStablecoin): RPCRequest;
     /**
+     * Generates a bridge transaction ready for client confirmation and broadcasting.
      *
-     * @param compiled operation
-     * @param signature
-     * @param rpc
-     * @returns
+     * @param compiled - The compiled bridge operation from RPC
+     * @param demos - Demos instance for signing (provides wallet and nonce)
+     * @returns Signed transaction ready for demos.confirm() and demos.broadcast()
      */
-    generateOperationTx(compiled: BridgeOperationCompiled): Transaction;
+    generateOperationTx(compiled: BridgeOperationCompiled, demos: Demos): Promise<Transaction>;
 };

package/build/bridge/nativeBridge.js

@@ -57,25 +57,31 @@ exports.methods = {
         return nodeCallPayload;
     },
     /**
+     * Generates a bridge transaction ready for client confirmation and broadcasting.
      *
-     * @param compiled operation
-     * @param signature
-     * @param rpc
-     * @returns
+     * @param compiled - The compiled bridge operation from RPC
+     * @param demos - Demos instance for signing (provides wallet and nonce)
+     * @returns Signed transaction ready for demos.confirm() and demos.broadcast()
      */
-    generateOperationTx(compiled) {
-        // TODO Implement the transaction once we have the compiled operation
-        // Preparing the known values for the transaction
+    async generateOperationTx(compiled, demos) {
+        // Extract addresses from the compiled operation
+        const operation = compiled.content.operation;
+        const from = operation.originAddress; // Source chain address
+        const to = operation.originAddress; // Same as from (reflexive transaction)
+        const from_ed25519_address = operation.demoAddress; // Demos address that started operation
+        // Get proper nonce from demos instance
+        const nonce = await demos.getAddressNonce(from_ed25519_address);
+        // Prepare the transaction structure
         const tx = {
             content: {
                 type: "nativeBridge",
                 data: ["nativeBridge", compiled],
-                from: "", // TODO Implement from using the identity
-                to: "", // TODO Same as from
-                from_ed25519_address: "",
-                amount: 0,
-                gcr_edits: [],
-                nonce: 0,
+                from: from,
+                to: to,
+                from_ed25519_address: from_ed25519_address,
+                amount: 0, // Always 0 for bridge operations
+                gcr_edits: [], // Will be generated by demos.sign()
+                nonce: nonce + 1,
                 timestamp: Date.now(),
                 transaction_fee: {
                     network_fee: 0,
@@ -92,8 +98,11 @@ exports.methods = {
             blockNumber: 0,
             ed25519_signature: ""
         };
-        // TODO Hash and sign the transaction
-        return tx;
+        // Use demos.sign() which handles GCR generation, hashing, and signing
+        const signedTx = await demos.sign(tx);
+        // NOTE: Client must call demos.confirm(signedTx) then demos.broadcast(validationData)
+        // to complete the transaction flow, following the same pattern as pay() transactions
+        return signedTx;
     },
 };
 //# sourceMappingURL=nativeBridge.js.map

package/build/bridge/nativeBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"nativeBridge.js","sourceRoot":"","sources":["../../../src/bridge/nativeBridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nativeBridge.js","sourceRoot":"","sources":["../../../src/bridge/nativeBridge.ts"],"names":[],"mappings":";;;AAAA,6CAAqE;AACrE,2DAS4B;AAOf,QAAA,OAAO,GAAG;IACnB;;;;;OAKG;IACH,aAAa,CACT,KAAa,EACb,SAAiB,EACjB,QAAiB;QAEjB,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAA;QACxD,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,sCAAkB,CAAC,QAAQ,CAAC,KAA0B,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,KAAK,CACX,WAAW,YAAY,WAAW,KAAK,yBAAyB,CACnE,CAAA;YACL,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IACI,CAAC,yCAAqB,CAAC,QAAQ,CAC3B,KAA6B,CAChC,EACH,CAAC;gBACC,MAAM,IAAI,KAAK,CACX,WAAW,YAAY,WAAW,KAAK,2BAA2B,CACrE,CAAA;YACL,CAAC;QACL,CAAC;IACL,CAAC;IACD;;;;OAIG;IACH,iBAAiB,CACb,UAAkB,EAClB,SAAiB,EACjB,eAA+B,EAC/B,WAAqD,EACrD,oBAAoC,EACpC,gBAA0D,EAC1D,aAAqB,EACrB,kBAA0B,EAC1B,MAAc,EACd,KAA0B;QAE1B,uDAAuD;QACvD,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,eAAe,EAAE,IAAI,CAAC,CAAA;QACtD,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,KAAK,CAAC,CAAA;QACjE,yBAAyB;QACzB,MAAM,SAAS,GAAoB;YAC/B,WAAW,EAAE,SAAS;YACtB,eAAe,EAAE,eAAe;YAChC,WAAW,EAAE,WAAW;YACxB,oBAAoB,EAAE,oBAAoB;YAC1C,gBAAgB,EAAE,gBAAgB;YAClC,aAAa,EAAE,aAAa;YAC5B,kBAAkB,EAAE,kBAAkB;YACtC,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,OAAO;SAClB,CAAA;QACD,4BAA4B;QAC5B,IAAI,MAAM,GAAG,oBAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAA;QACtD,IAAI,SAAS,GAAG,yBAAY,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;QACrD,IAAI,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACtD,IAAI,eAAe,GAAe;YAC9B,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;SACpC,CAAA;QACD,OAAO,eAAe,CAAA;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CAAC,QAAiC,EAAE,KAAY;QACrE,gDAAgD;QAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAA;QAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,aAAa,CAAA,CAAM,uBAAuB;QACjE,MAAM,EAAE,GAAG,SAAS,CAAC,aAAa,CAAA,CAAQ,uCAAuC;QACjF,MAAM,oBAAoB,GAAG,SAAS,CAAC,WAAW,CAAA,CAAE,uCAAuC;QAE3F,uCAAuC;QACvC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAA;QAE/D,oCAAoC;QACpC,MAAM,EAAE,GAAgB;YACpB,OAAO,EAAE;gBACL,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC;gBAChC,IAAI,EAAE,IAAI;gBACV,EAAE,EAAE,EAAE;gBACN,oBAAoB,EAAE,oBAAoB;gBAC1C,MAAM,EAAE,CAAC,EAAG,iCAAiC;gBAC7C,SAAS,EAAE,EAAE,EAAG,oCAAoC;gBACpD,KAAK,EAAE,KAAK,GAAG,CAAC;gBAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,eAAe,EAAE;oBACb,WAAW,EAAE,CAAC;oBACd,OAAO,EAAE,CAAC;oBACV,cAAc,EAAE,CAAC;iBACpB;aACJ;YACD,SAAS,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,EAAE;aACX;YACD,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,CAAC;YACd,iBAAiB,EAAE,EAAE;SACxB,CAAA;QAED,sEAAsE;QACtE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAErC,sFAAsF;QACtF,qFAAqF;QACrF,OAAO,QAAQ,CAAA;IACnB,CAAC;CACJ,CAAA"}

package/build/multichain/core/aptos.d.ts

@@ -1,6 +1,7 @@
 import { Aptos, Network, Account, SimpleTransaction, UserTransactionResponse } from "@aptos-labs/ts-sdk";
 import { DefaultChain } from "./types/defaultChain";
 import { IPayParams } from "./types/interfaces";
+import { XMScript } from "../../types";
 /**
  * Extension methods for the Aptos Default Chain SDK
  */
@@ -8,6 +9,12 @@ export interface AptosDefaultChain extends DefaultChain {
     aptos: Aptos;
     account: Account | null;
     network: Network;
+    wallet: Account | null;
+    /**
+     * Gets the public key of the connected wallet
+     * @returns The public key as hex string
+     */
+    getPublicKey: () => string;
     /**
      * Get APT balance for an account (default: XM operation)
      */
@@ -27,7 +34,7 @@ export interface AptosDefaultChain extends DefaultChain {
     /**
      * Read from a smart contract (default: XM operation)
      */
-    readFromContract: (moduleAddress: string, moduleName: string, functionName: string, args: any[], typeArguments?: string[]) => Promise<any>;
+    readFromContract: (moduleAddress: string, moduleName: string, functionName: string, args: any[], typeArguments?: string[]) => Promise<XMScript>;
     /**
      * Read from a smart contract directly (bypasses Demos Network)
      */
@@ -35,7 +42,7 @@ export interface AptosDefaultChain extends DefaultChain {
     /**
      * Write to a smart contract (entry function) - returns signed transaction for XM
      */
-    writeToContract: (moduleAddress: string, moduleName: string, functionName: string, args: any[], typeArguments?: string[]) => Promise<Uint8Array>;
+    writeToContract: (moduleAddress: string, moduleName: string, functionName: string, args: any[], typeArguments?: string[]) => Promise<XMScript>;
     /**
      * Wait for transaction confirmation
      */
@@ -60,6 +67,7 @@ export declare class APTOS extends DefaultChain implements AptosDefaultChain {
     setNetwork(network: Network): void;
     /**
      * Connects to the Aptos network
+     *
      * @returns A boolean indicating whether the connection was successful
      */
     connect(): Promise<boolean>;
@@ -70,93 +78,111 @@ export declare class APTOS extends DefaultChain implements AptosDefaultChain {
      */
     connectWallet(privateKey: string): Promise<Account>;
     /**
-     * Gets the APT balance directly from Aptos RPC (bypasses Demos Network)
-     * Use only when explicit direct access is needed
-     * @param address The wallet address
-     * @returns The balance as a string (in Octas, 1 APT = 100,000,000 Octas)
-     */
-    getBalanceDirect(address: string): Promise<string>;
-    /**
-     * Gets the APT balance directly using official SDK method (bypasses Demos Network)
-     * Use only when explicit direct access is needed
+     * Gets the APT balance directly from Aptos RPC given an address
+     *
+     * The other get balance methods use this method to get the balance
+     *
      * @param address The wallet address
      * @returns The balance as a string (in Octas)
      */
     getAPTBalanceDirect(address: string): Promise<string>;
     /**
-     * Gets the balance of a specific coin type directly (bypasses Demos Network)
-     * Use only when explicit direct access is needed
+     * Gets the balance of a specific coin type directly from Aptos RPC given a coin type and address
+     *
+     * The other get balance methods use this method to get the balance
+     *
      * @param coinType The coin type (e.g., "0x1::aptos_coin::AptosCoin")
      * @param address The wallet address
      * @returns The balance as a string
      */
     getCoinBalanceDirect(coinType: string, address: string): Promise<string>;
     /**
-     * Gets the APT balance via Demos Network XM operation (default behavior)
+     * Gets the APT balance from the Aptos network given an address
+     *
      * @param address The wallet address
      * @returns XM operation object for Demos Network relay
      */
     getBalance(address: string): Promise<any>;
     /**
-     * Gets the APT balance via Demos Network XM operation (default behavior)
+     * Gets the APT balance from the Aptos network given an address
+     *
      * @param address The wallet address
      * @returns XM operation object for Demos Network relay
      */
     getAPTBalance(address: string): Promise<any>;
     /**
-     * Gets the coin balance via Demos Network XM operation (default behavior)
+     * Gets a coin balance from the Aptos network given a coin type and address
+     *
      * @param coinType The coin type (e.g., "0x1::aptos_coin::AptosCoin")
      * @param address The wallet address
+     *
      * @returns XM operation object for Demos Network relay
      */
     getCoinBalance(coinType: string, address: string): Promise<any>;
     /**
      * Creates a signed transaction to transfer APT
+     *
      * @param receiver The receiver's address
      * @param amount The amount to transfer (in Octas)
-     * @returns The signed transaction
+     *
+     * @returns The signed Aptos transaction as hex string
      */
-    preparePay(receiver: string, amount: string): Promise<Uint8Array>;
+    preparePay(receiver: string, amount: string): Promise<string>;
     /**
      * Creates multiple signed transactions to transfer APT
+     *
      * @param payments Array of payment parameters
-     * @returns Array of signed transactions
+     *
+     * @returns Array of signed Aptos transactions as hex strings
      */
-    preparePays(payments: IPayParams[]): Promise<Uint8Array[]>;
+    preparePays(payments: IPayParams[]): Promise<string[]>;
     /**
      * Creates an empty transaction template
      */
     getEmptyTransaction(): Promise<SimpleTransaction>;
+    /**
+     * Gets the public key of the connected wallet
+     *
+     * @returns The public key as hex string
+     */
+    getPublicKey(): string;
     /**
      * Returns the address of the connected wallet
+     *
+     * @returns The wallet address as hex string
      */
     getAddress(): string;
     /**
      * Signs a message using the connected wallet
      * @param message The message to sign
-     * @returns The signed message
+     *
+     * @returns The signed message as hex string
      */
-    signMessage(message: string): Promise<Uint8Array>;
+    signMessage(message: string): Promise<string>;
     /**
      * Verifies a message signature
+     *
      * @param message The original message
      * @param signature The signature to verify
      * @param publicKey The public key to verify against
+     *
      * @returns Boolean indicating if the signature is valid
      */
-    verifyMessage(message: string, signature: string | Uint8Array, publicKey: string | Uint8Array): Promise<boolean>;
+    verifyMessage(message: string, signature: string, publicKey: string): Promise<boolean>;
     /**
      * Signs a transaction using the connected wallet
      * @param transaction The transaction to sign
-     * @returns The signed transaction
+     *
+     * @returns The signed Aptos transaction as hex string
      */
-    signTransaction(transaction: SimpleTransaction): Promise<Uint8Array>;
+    signTransaction(transaction: SimpleTransaction): Promise<string>;
     /**
      * Signs multiple transactions
      * @param transactions Array of transactions to sign
-     * @returns Array of signed transactions
+     *
+     * @returns Array of signed Aptos transactions as hex strings
      */
-    signTransactions(transactions: SimpleTransaction[]): Promise<Uint8Array[]>;
+    signTransactions(transactions: SimpleTransaction[]): Promise<string[]>;
     /**
      * Read from a smart contract directly (bypasses Demos Network)
      * Use only when explicit direct access is needed
@@ -165,6 +191,7 @@ export declare class APTOS extends DefaultChain implements AptosDefaultChain {
      * @param functionName The function name
      * @param args Function arguments
      * @param typeArguments Type arguments for generic functions (optional)
+     *
      * @returns The function result
      */
     readFromContractDirect(moduleAddress: string, moduleName: string, functionName: string, args: any[], typeArguments?: string[]): Promise<any>;
@@ -175,9 +202,10 @@ export declare class APTOS extends DefaultChain implements AptosDefaultChain {
      * @param functionName The function name
      * @param args Function arguments
      * @param typeArguments Type arguments for generic functions (optional)
-     * @returns XM operation object for Demos Network relay
+     *
+     * @returns The XMScript object ready to be used in a Demos transaction
      */
-    readFromContract(moduleAddress: string, moduleName: string, functionName: string, args: any[], typeArguments?: string[]): Promise<any>;
+    readFromContract(moduleAddress: string, moduleName: string, functionName: string, args: any[], typeArguments?: string[]): Promise<XMScript>;
     /**
      * Prepare a smart contract write transaction for Demos Network relay
      * Builds transaction for XM operations - does NOT execute directly
@@ -187,9 +215,10 @@ export declare class APTOS extends DefaultChain implements AptosDefaultChain {
      * @param functionName The function name
      * @param args Function arguments
      * @param typeArguments Type arguments (optional)
-     * @returns The serialized transaction bytes for XM relay
+     *
+     * @returns The XMScript object ready to be used in a Demos transaction
      */
-    writeToContract(moduleAddress: string, moduleName: string, functionName: string, args: any[], typeArguments?: string[]): Promise<Uint8Array>;
+    writeToContract(moduleAddress: string, moduleName: string, functionName: string, args: any[], typeArguments?: string[]): Promise<XMScript>;
     /**
      * Wait for transaction confirmation
      * @param transactionHash The transaction hash