@n1xyz/nord-ts 0.0.1 → 0.0.4

package/dist/solana/client.d.ts

@@ -0,0 +1,139 @@
+import * as anchor from '@coral-xyz/anchor';
+import { Connection, PublicKey, Keypair } from '@solana/web3.js';
+import { BlockFacts, DepositSplParams, PdaSeedType, SolanaBridgeConfig, WithdrawalParams } from './types';
+/**
+ * Solana Bridge Client for interacting with the bridge program
+ */
+export declare class SolanaBridgeClient {
+    /** Anchor program instance */
+    program: any;
+    /** Solana connection */
+    connection: Connection;
+    /** Program ID */
+    programId: PublicKey;
+    /** Configuration */
+    config: SolanaBridgeConfig;
+    /**
+     * Create a new Solana Bridge Client
+     *
+     * @param config Bridge configuration
+     * @param wallet Anchor wallet for signing transactions
+     */
+    constructor(config: SolanaBridgeConfig, wallet: anchor.Wallet);
+    /**
+     * Derive a PDA (Program Derived Address) for the given seeds
+     *
+     * @param type PDA seed type
+     * @param seeds Additional seeds
+     * @returns [PDA, bump]
+     */
+    findPda(type: PdaSeedType, ...seeds: (Buffer | PublicKey | string | number)[]): Promise<[PublicKey, number]>;
+    /**
+     * Find the contract storage PDA
+     *
+     * @returns [PDA, bump]
+     */
+    findContractStoragePda(): Promise<[PublicKey, number]>;
+    /**
+     * Find the asset whitelisted PDA for a token mint
+     *
+     * @param mint Token mint address
+     * @returns [PDA, bump]
+     */
+    findAssetWhitelistedPda(mint: PublicKey): Promise<[PublicKey, number]>;
+    /**
+     * Find the deposit storage PDA for a deposit index
+     *
+     * @param depositIndex Deposit index
+     * @returns [PDA, bump]
+     */
+    findDepositStoragePda(depositIndex: number): Promise<[PublicKey, number]>;
+    /**
+     * Find the block storage PDA for a block ID
+     *
+     * @param blockId Block ID
+     * @returns [PDA, bump]
+     */
+    findBlockStoragePda(blockId: number): Promise<[PublicKey, number]>;
+    /**
+     * Find the withdrawal nullifier PDA
+     *
+     * @param blockId Block ID
+     * @param leafIndex Leaf index
+     * @returns [PDA, bump]
+     */
+    findWithdrawalNullifierPda(blockId: number, leafIndex: number): Promise<[PublicKey, number]>;
+    /**
+     * Find the authority PDA
+     *
+     * @returns [PDA, bump]
+     */
+    findAuthorityPda(): Promise<[PublicKey, number]>;
+    /**
+     * Deposit SPL tokens to the bridge
+     *
+     * @param params Deposit parameters
+     * @param signer Signer keypair
+     * @returns Transaction signature
+     */
+    depositSpl(params: DepositSplParams, signer: Keypair): Promise<string>;
+    /**
+     * Withdraw tokens from the bridge
+     *
+     * @param params Withdrawal parameters
+     * @param signer Signer keypair
+     * @returns Transaction signature
+     */
+    withdraw(params: WithdrawalParams, signer: Keypair): Promise<string>;
+    /**
+     * Whitelist an asset (token) for use with the bridge
+     *
+     * @param mint Token mint address
+     * @param signer Operator keypair
+     * @returns Transaction signature
+     */
+    whitelistAsset(mint: PublicKey, signer: Keypair): Promise<string>;
+    /**
+     * Propose a new block
+     *
+     * @param facts Block facts
+     * @param signer Operator keypair
+     * @returns Transaction signature
+     */
+    proposeBlock(facts: BlockFacts, signer: Keypair): Promise<string>;
+    /**
+     * Finalize a block
+     *
+     * @param blockId Block ID
+     * @param stateUpdateId State update ID
+     * @param signer Payer keypair
+     * @returns Transaction signature
+     */
+    finalizeBlock(blockId: number, stateUpdateId: number, signer: Keypair): Promise<string>;
+    /**
+     * Finalize a DA fact
+     *
+     * @param fact DA fact (32-byte array)
+     * @param signer Payer keypair
+     * @returns Transaction signature
+     */
+    finalizeDaFact(fact: Buffer, signer: Keypair): Promise<string>;
+    /**
+     * Initialize the bridge contract
+     *
+     * @param operator Operator public key
+     * @param initialAppStateCommitment Initial app state commitment (32-byte array)
+     * @param signer Payer keypair
+     * @returns Transaction signature
+     */
+    initialize(operator: PublicKey, initialAppStateCommitment: Buffer, signer: Keypair): Promise<string>;
+    /**
+     * Create an associated token account if it doesn't exist
+     *
+     * @param mint Token mint
+     * @param owner Account owner
+     * @param payer Transaction payer
+     * @returns Associated token account address
+     */
+    createTokenAccountIfNeeded(mint: PublicKey, owner: PublicKey, payer: Keypair): Promise<PublicKey>;
+}

package/dist/solana/client.js

@@ -0,0 +1,360 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolanaBridgeClient = void 0;
+const anchor = __importStar(require("@coral-xyz/anchor"));
+const anchor_1 = require("@coral-xyz/anchor");
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const types_1 = require("./types");
+// Import the BRIDGE_IDL
+const bridge_1 = require("../idl/bridge");
+/**
+ * Solana Bridge Client for interacting with the bridge program
+ */
+class SolanaBridgeClient {
+    /**
+     * Create a new Solana Bridge Client
+     *
+     * @param config Bridge configuration
+     * @param wallet Anchor wallet for signing transactions
+     */
+    constructor(config, wallet) {
+        this.config = config;
+        this.connection = new web3_js_1.Connection(config.rpcUrl, {
+            commitment: config.commitment
+        });
+        this.programId = new web3_js_1.PublicKey(config.programId);
+        // Create the provider
+        const provider = new anchor_1.AnchorProvider(this.connection, wallet, { commitment: config.commitment });
+        // Set the provider globally
+        anchor.setProvider(provider);
+        // Initialize the program with the IDL using a type cast to work around type issues
+        const ProgramClass = anchor.Program;
+        this.program = new ProgramClass(bridge_1.BRIDGE_IDL, this.programId, provider);
+    }
+    /**
+     * Derive a PDA (Program Derived Address) for the given seeds
+     *
+     * @param type PDA seed type
+     * @param seeds Additional seeds
+     * @returns [PDA, bump]
+     */
+    async findPda(type, ...seeds) {
+        const seedBuffers = [
+            Buffer.from(type),
+            ...seeds.map(seed => {
+                if (seed instanceof web3_js_1.PublicKey) {
+                    return seed.toBuffer();
+                }
+                else if (typeof seed === 'string') {
+                    return Buffer.from(seed);
+                }
+                else if (typeof seed === 'number') {
+                    return Buffer.from([seed]);
+                }
+                return seed;
+            })
+        ];
+        return web3_js_1.PublicKey.findProgramAddressSync(seedBuffers, this.programId);
+    }
+    /**
+     * Find the contract storage PDA
+     *
+     * @returns [PDA, bump]
+     */
+    async findContractStoragePda() {
+        return this.findPda(types_1.PdaSeedType.ContractStorage);
+    }
+    /**
+     * Find the asset whitelisted PDA for a token mint
+     *
+     * @param mint Token mint address
+     * @returns [PDA, bump]
+     */
+    async findAssetWhitelistedPda(mint) {
+        return this.findPda(types_1.PdaSeedType.AssetWhitelisted, mint);
+    }
+    /**
+     * Find the deposit storage PDA for a deposit index
+     *
+     * @param depositIndex Deposit index
+     * @returns [PDA, bump]
+     */
+    async findDepositStoragePda(depositIndex) {
+        return this.findPda(types_1.PdaSeedType.DepositStorage, depositIndex);
+    }
+    /**
+     * Find the block storage PDA for a block ID
+     *
+     * @param blockId Block ID
+     * @returns [PDA, bump]
+     */
+    async findBlockStoragePda(blockId) {
+        return this.findPda(types_1.PdaSeedType.BlockStorage, blockId);
+    }
+    /**
+     * Find the withdrawal nullifier PDA
+     *
+     * @param blockId Block ID
+     * @param leafIndex Leaf index
+     * @returns [PDA, bump]
+     */
+    async findWithdrawalNullifierPda(blockId, leafIndex) {
+        return this.findPda(types_1.PdaSeedType.WithdrawalNullifier, blockId, leafIndex);
+    }
+    /**
+     * Find the authority PDA
+     *
+     * @returns [PDA, bump]
+     */
+    async findAuthorityPda() {
+        return this.findPda(types_1.PdaSeedType.Authority);
+    }
+    /**
+     * Deposit SPL tokens to the bridge
+     *
+     * @param params Deposit parameters
+     * @param signer Signer keypair
+     * @returns Transaction signature
+     */
+    async depositSpl(params, signer) {
+        const [contractStorage] = await this.findContractStoragePda();
+        const [assetWhitelisted] = await this.findAssetWhitelistedPda(params.mint);
+        // Get the last deposit index from contract storage
+        const contractStorageAccount = await this.program.account.contractStorage.fetch(contractStorage);
+        const lastDepositIndex = contractStorageAccount.lastDepositIndex.toNumber();
+        // Find the deposit PDA for this deposit
+        const [deposit] = await this.findDepositStoragePda(lastDepositIndex + 1);
+        // Find the previous deposit PDA if it exists
+        let prevDeposit = undefined;
+        if (lastDepositIndex > 0) {
+            const [prevDepositPda] = await this.findDepositStoragePda(lastDepositIndex);
+            prevDeposit = prevDepositPda;
+        }
+        // Build the transaction
+        const accounts = {
+            depositor: signer.publicKey,
+            deposit,
+            assetWhitelisted,
+            contractStorage,
+            fromAccount: params.fromAccount,
+            toAccount: params.toAccount,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        };
+        // Add prevDeposit only if it exists
+        if (prevDeposit) {
+            accounts.prevDeposit = prevDeposit;
+        }
+        const tx = await this.program.methods
+            .depositSpl(params.amount)
+            .accounts(accounts)
+            .transaction();
+        // Sign and send the transaction
+        return await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, tx, [signer], { commitment: this.config.commitment });
+    }
+    /**
+     * Withdraw tokens from the bridge
+     *
+     * @param params Withdrawal parameters
+     * @param signer Signer keypair
+     * @returns Transaction signature
+     */
+    async withdraw(params, signer) {
+        const [stateUpdate] = await this.findBlockStoragePda(params.claim.blockId.toNumber());
+        const [withdrawalNullifier] = await this.findWithdrawalNullifierPda(params.claim.blockId.toNumber(), params.claim.leafIndex.toNumber());
+        const [authority] = await this.findAuthorityPda();
+        // Build the transaction
+        const tx = await this.program.methods
+            .withdraw(params.claim)
+            .accounts({
+            payer: signer.publicKey,
+            stateUpdate,
+            withdrawalNullifier,
+            fromAccount: params.fromAccount,
+            toAccount: params.toAccount,
+            authority,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .transaction();
+        // Sign and send the transaction
+        return await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, tx, [signer], { commitment: this.config.commitment });
+    }
+    /**
+     * Whitelist an asset (token) for use with the bridge
+     *
+     * @param mint Token mint address
+     * @param signer Operator keypair
+     * @returns Transaction signature
+     */
+    async whitelistAsset(mint, signer) {
+        const [contractStorage] = await this.findContractStoragePda();
+        const [assetWhitelisted] = await this.findAssetWhitelistedPda(mint);
+        // Build the transaction
+        const tx = await this.program.methods
+            .whitelistAsset(mint)
+            .accounts({
+            operator: signer.publicKey,
+            contractStorage,
+            assetWhitelisted,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .transaction();
+        // Sign and send the transaction
+        return await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, tx, [signer], { commitment: this.config.commitment });
+    }
+    /**
+     * Propose a new block
+     *
+     * @param facts Block facts
+     * @param signer Operator keypair
+     * @returns Transaction signature
+     */
+    async proposeBlock(facts, signer) {
+        const [contractStorage] = await this.findContractStoragePda();
+        // Get the last block ID from contract storage
+        const contractStorageAccount = await this.program.account.contractStorage.fetch(contractStorage);
+        const [block] = await this.findBlockStoragePda(contractStorageAccount.lastBlockId.toNumber() + 1);
+        // Find the last deposit PDA
+        const [lastDeposit] = await this.findDepositStoragePda(facts.nextStateFacts.lastDepositIndex.toNumber());
+        // Find the DA fact state
+        const daFactState = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(types_1.PdaSeedType.DaFactStorage), facts.daCommitment], this.programId)[0];
+        // Build the transaction
+        const tx = await this.program.methods
+            .proposeBlock(facts)
+            .accounts({
+            operator: signer.publicKey,
+            block,
+            lastDeposit,
+            daFactState,
+            contractStorage,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .transaction();
+        // Sign and send the transaction
+        return await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, tx, [signer], { commitment: this.config.commitment });
+    }
+    /**
+     * Finalize a block
+     *
+     * @param blockId Block ID
+     * @param stateUpdateId State update ID
+     * @param signer Payer keypair
+     * @returns Transaction signature
+     */
+    async finalizeBlock(blockId, stateUpdateId, signer) {
+        const [contractStorage] = await this.findContractStoragePda();
+        const [block] = await this.findBlockStoragePda(blockId);
+        // Build the transaction
+        const tx = await this.program.methods
+            .finalizeBlock(new anchor.BN(stateUpdateId))
+            .accounts({
+            payer: signer.publicKey,
+            block,
+            contractStorage,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .transaction();
+        // Sign and send the transaction
+        return await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, tx, [signer], { commitment: this.config.commitment });
+    }
+    /**
+     * Finalize a DA fact
+     *
+     * @param fact DA fact (32-byte array)
+     * @param signer Payer keypair
+     * @returns Transaction signature
+     */
+    async finalizeDaFact(fact, signer) {
+        const factStateStorage = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(types_1.PdaSeedType.DaFactStorage), fact], this.programId)[0];
+        // Build the transaction
+        const tx = await this.program.methods
+            .finalizeDaFact(Array.from(fact))
+            .accounts({
+            payer: signer.publicKey,
+            factStateStorage,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .transaction();
+        // Sign and send the transaction
+        return await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, tx, [signer], { commitment: this.config.commitment });
+    }
+    /**
+     * Initialize the bridge contract
+     *
+     * @param operator Operator public key
+     * @param initialAppStateCommitment Initial app state commitment (32-byte array)
+     * @param signer Payer keypair
+     * @returns Transaction signature
+     */
+    async initialize(operator, initialAppStateCommitment, signer) {
+        const [contractStorage] = await this.findContractStoragePda();
+        // Build the transaction
+        const tx = await this.program.methods
+            .initialize(operator, Array.from(initialAppStateCommitment))
+            .accounts({
+            payer: signer.publicKey,
+            program: this.programId,
+            contractStorage,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .transaction();
+        // Sign and send the transaction
+        return await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, tx, [signer], { commitment: this.config.commitment });
+    }
+    /**
+     * Create an associated token account if it doesn't exist
+     *
+     * @param mint Token mint
+     * @param owner Account owner
+     * @param payer Transaction payer
+     * @returns Associated token account address
+     */
+    async createTokenAccountIfNeeded(mint, owner, payer) {
+        const associatedTokenAddress = await (0, spl_token_1.getAssociatedTokenAddress)(mint, owner);
+        try {
+            await this.connection.getTokenAccountBalance(associatedTokenAddress);
+        }
+        catch (error) {
+            // Account doesn't exist, create it
+            const transaction = new web3_js_1.Transaction().add((0, spl_token_1.createAssociatedTokenAccountInstruction)(payer.publicKey, associatedTokenAddress, owner, mint));
+            await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, transaction, [payer], { commitment: this.config.commitment });
+        }
+        return associatedTokenAddress;
+    }
+}
+exports.SolanaBridgeClient = SolanaBridgeClient;

package/dist/solana/const.d.ts

@@ -0,0 +1,23 @@
+import { SPLTokenInfo } from './types';
+import { Commitment } from '@solana/web3.js';
+export declare const SOLANA_MAINNET_URL = "https://api.mainnet-beta.solana.com";
+export declare const SOLANA_DEVNET_URL = "https://api.devnet.solana.com";
+export declare const SOLANA_TESTNET_URL = "https://api.testnet.solana.com";
+export declare const SOLANA_LOCALNET_URL = "http://localhost:8899";
+export declare const DEFAULT_COMMITMENT: Commitment;
+export declare const DEV_URL = "http://localhost";
+export declare const WEBSERVER_DEV_URL: string;
+export declare const SOLANA_PROGRAM_ID = "CVDFLCAjXhVWiPXH9nTCTpCgVzmDVoiPzNJYuccr1dqB";
+export declare const DEV_TOKEN_INFOS: SPLTokenInfo[];
+export declare const DEFAULT_FUNDING_AMOUNTS: {
+    [key: string]: [string, number];
+};
+export declare const PDA_SEEDS: {
+    CONTRACT_STORAGE: string;
+    ASSET_WHITELISTED: string;
+    DEPOSIT_STORAGE: string;
+    BLOCK_STORAGE: string;
+    WITHDRAWAL_NULLIFIER: string;
+    AUTHORITY: string;
+    DA_FACT_STORAGE: string;
+};

package/dist/solana/const.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PDA_SEEDS = exports.DEFAULT_FUNDING_AMOUNTS = exports.DEV_TOKEN_INFOS = exports.SOLANA_PROGRAM_ID = exports.WEBSERVER_DEV_URL = exports.DEV_URL = exports.DEFAULT_COMMITMENT = exports.SOLANA_LOCALNET_URL = exports.SOLANA_TESTNET_URL = exports.SOLANA_DEVNET_URL = exports.SOLANA_MAINNET_URL = void 0;
+// Solana RPC endpoints
+exports.SOLANA_MAINNET_URL = 'https://api.mainnet-beta.solana.com';
+exports.SOLANA_DEVNET_URL = 'https://api.devnet.solana.com';
+exports.SOLANA_TESTNET_URL = 'https://api.testnet.solana.com';
+exports.SOLANA_LOCALNET_URL = 'http://localhost:8899';
+// Default commitment level
+exports.DEFAULT_COMMITMENT = 'confirmed';
+// Webserver configuration
+const WEBSERVER_PORT = "80";
+exports.DEV_URL = "http://localhost";
+exports.WEBSERVER_DEV_URL = exports.DEV_URL + ":" + WEBSERVER_PORT;
+// Program ID (will be supplied externally)
+exports.SOLANA_PROGRAM_ID = 'CVDFLCAjXhVWiPXH9nTCTpCgVzmDVoiPzNJYuccr1dqB';
+// Sample token information for development
+exports.DEV_TOKEN_INFOS = [
+    {
+        mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC on devnet
+        precision: 6,
+        tokenId: 0,
+        name: 'usdc',
+    },
+    {
+        mint: 'So11111111111111111111111111111111111111112', // Wrapped SOL
+        precision: 9,
+        tokenId: 1,
+        name: 'sol',
+    },
+];
+// Default funding amounts for development
+exports.DEFAULT_FUNDING_AMOUNTS = {
+    SOL: ["0.2", 9],
+    // USDC mint address
+    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": ["10000", 6],
+};
+// PDA seed constants
+exports.PDA_SEEDS = {
+    CONTRACT_STORAGE: 'contract_storage',
+    ASSET_WHITELISTED: 'asset_whitelisted',
+    DEPOSIT_STORAGE: 'deposit_storage',
+    BLOCK_STORAGE: 'block_storage',
+    WITHDRAWAL_NULLIFIER: 'withdrawal_nullifier',
+    AUTHORITY: 'authority',
+    DA_FACT_STORAGE: 'da_fact_storage',
+};

package/dist/solana/index.d.ts

@@ -0,0 +1,5 @@
+export * from './client';
+export * from './types';
+export * from './utils';
+import { BRIDGE_IDL } from '../idl/bridge';
+export { BRIDGE_IDL };

package/dist/solana/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BRIDGE_IDL = void 0;
+__exportStar(require("./client"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);
+// Re-export the IDL for convenience
+const bridge_1 = require("../idl/bridge");
+Object.defineProperty(exports, "BRIDGE_IDL", { enumerable: true, get: function () { return bridge_1.BRIDGE_IDL; } });