@zelana/sdk 0.1.0

package/dist/keypair.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Zelana Keypair - Ed25519 key management and signing
+ *
+ * Provides key generation, import/export, and transaction signing.
+ */
+import type { Bytes32, TransferRequest, WithdrawRequest } from './types';
+/**
+ * Zelana Keypair for L2 transactions
+ *
+ * Wraps an Ed25519 keypair and provides signing methods for
+ * transfers, withdrawals, and other L2 operations.
+ */
+export declare class Keypair {
+    private readonly secretKey;
+    private readonly _publicKey;
+    private constructor();
+    /**
+     * Generate a new random keypair
+     */
+    static generate(): Keypair;
+    /**
+     * Create keypair from a 32-byte secret key (seed)
+     */
+    static fromSecretKey(secretKey: Uint8Array): Keypair;
+    /**
+     * Create keypair from hex-encoded secret key
+     */
+    static fromHex(hex: string): Keypair;
+    /**
+     * Create keypair from base58-encoded secret key
+     */
+    static fromBase58(base58: string): Keypair;
+    /**
+     * Get the public key as Uint8Array
+     */
+    get publicKey(): Bytes32;
+    /**
+     * Get the public key as hex string
+     */
+    get publicKeyHex(): string;
+    /**
+     * Get the public key as base58 string (Solana format)
+     */
+    get publicKeyBase58(): string;
+    /**
+     * Get the secret key as hex string (be careful with this!)
+     */
+    get secretKeyHex(): string;
+    /**
+     * Get the secret key as base58 string
+     */
+    get secretKeyBase58(): string;
+    /**
+     * Sign arbitrary message bytes
+     */
+    sign(message: Uint8Array): Uint8Array;
+    /**
+     * Verify a signature (static method)
+     */
+    static verify(signature: Uint8Array, message: Uint8Array, publicKey: Uint8Array): boolean;
+    /**
+     * Sign a transfer transaction
+     *
+     * The message format matches the Rust TransactionData wincode serialization:
+     * - from: [u8; 32]
+     * - to: [u8; 32]
+     * - amount: u64 (little-endian)
+     * - nonce: u64 (little-endian)
+     * - chain_id: u64 (little-endian)
+     */
+    signTransfer(to: Bytes32, amount: bigint, nonce: bigint, chainId?: bigint): TransferRequest;
+    /**
+     * Sign a withdrawal request
+     *
+     * The message format matches the Rust withdrawal verification:
+     * - from: [u8; 32]
+     * - to_l1_address: [u8; 32]
+     * - amount: u64 (little-endian)
+     * - nonce: u64 (little-endian)
+     */
+    signWithdrawal(toL1Address: Bytes32, amount: bigint, nonce: bigint): WithdrawRequest;
+}
+/**
+ * PublicKey wrapper for address representation
+ */
+export declare class PublicKey {
+    private readonly bytes;
+    constructor(input: Uint8Array | string);
+    /**
+     * Get bytes representation
+     */
+    toBytes(): Bytes32;
+    /**
+     * Get hex string representation
+     */
+    toHex(): string;
+    /**
+     * Get base58 representation (Solana format)
+     */
+    toBase58(): string;
+    /**
+     * Default string representation is base58
+     */
+    toString(): string;
+    /**
+     * Check equality with another public key
+     */
+    equals(other: PublicKey | Uint8Array): boolean;
+}
+//# sourceMappingURL=keypair.d.ts.map

package/dist/keypair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keypair.d.ts","sourceRoot":"","sources":["../src/keypair.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAKzE;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,OAAO;IAM1B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO;IAQpD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU;IAIrC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO;IAQzF;;;;;;;;;OASG;IACH,YAAY,CACV,EAAE,EAAE,OAAO,EACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAkB,GAC1B,eAAe;IAuBlB;;;;;;;;OAQG;IACH,cAAc,CACZ,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,eAAe;CAoBnB;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEvB,KAAK,EAAE,UAAU,GAAG,MAAM;IAsBtC;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO;CAQ/C"}

package/dist/shielded.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Shielded Transaction Support
+ *
+ * Provides privacy-preserving transactions using note-based commitments.
+ *
+ * Note: This is a client-side helper. The actual ZK proof generation
+ * must be done by a separate prover (either WASM or native).
+ */
+import type { Bytes32 } from './types';
+/**
+ * A shielded note representing privately held value
+ */
+export interface Note {
+    /** The value held in this note */
+    value: bigint;
+    /** Random blinding factor (32 bytes) */
+    randomness: Bytes32;
+    /** Owner's shielded public key (32 bytes) */
+    ownerPk: Bytes32;
+    /** Position in the commitment tree (set after insertion) */
+    position?: bigint;
+}
+/**
+ * Encrypted note data (sent on-chain)
+ */
+export interface EncryptedNote {
+    /** Ephemeral public key for ECDH (32 bytes) */
+    ephemeralPk: Bytes32;
+    /** Nonce for ChaCha20-Poly1305 (12 bytes) */
+    nonce: Uint8Array;
+    /** Encrypted note data with authentication tag */
+    ciphertext: Uint8Array;
+}
+/**
+ * Merkle path for proving note membership
+ */
+export interface MerklePath {
+    /** Sibling hashes from leaf to root */
+    siblings: Bytes32[];
+    /** Bit indicating left (0) or right (1) for each level */
+    indices: boolean[];
+}
+/**
+ * Shielded spending key bundle
+ */
+export interface ShieldedKeys {
+    /** Spending key - allows spending notes (keep secret!) */
+    spendingKey: Bytes32;
+    /** Viewing key - allows viewing notes (for auditors) */
+    viewingKey: Bytes32;
+    /** Public key / address (can be shared) */
+    publicKey: Bytes32;
+}
+/**
+ * Input for a shielded transaction (spending a note)
+ */
+export interface ShieldedInput {
+    /** The note being spent */
+    note: Note;
+    /** Merkle path proving note is in the tree */
+    merklePath: MerklePath;
+    /** Spending key for this note */
+    spendingKey: Bytes32;
+}
+/**
+ * Output for a shielded transaction (creating a note)
+ */
+export interface ShieldedOutput {
+    /** Recipient's shielded public key */
+    recipientPk: Bytes32;
+    /** Amount to send */
+    value: bigint;
+    /** Optional memo (max 512 bytes) */
+    memo?: Uint8Array;
+}
+/**
+ * Prepared shielded transaction (ready for proving)
+ */
+export interface PreparedShieldedTx {
+    /** Nullifiers for spent notes */
+    nullifiers: Bytes32[];
+    /** Commitments for new notes */
+    commitments: Bytes32[];
+    /** Encrypted outputs for recipients */
+    encryptedOutputs: EncryptedNote[];
+    /** Merkle root being referenced */
+    merkleRoot: Bytes32;
+    /** Witness data for ZK proof (internal) */
+    witness: ShieldedWitness;
+}
+/**
+ * Witness data for ZK proof generation
+ */
+export interface ShieldedWitness {
+    inputs: Array<{
+        note: Note;
+        merklePath: MerklePath;
+        spendingKey: Bytes32;
+        nullifier: Bytes32;
+    }>;
+    outputs: Array<{
+        note: Note;
+        commitment: Bytes32;
+    }>;
+}
+/**
+ * Shielded transaction ready for submission
+ */
+export interface ShieldedTransaction {
+    /** ZK proof bytes (Groth16) */
+    proof: Uint8Array;
+    /** Nullifiers (spent note identifiers) */
+    nullifiers: Bytes32[];
+    /** Commitments (new note identifiers) */
+    commitments: Bytes32[];
+    /** Encrypted notes for recipients */
+    encryptedOutputs: EncryptedNote[];
+}
+/**
+ * Generate a new shielded key bundle
+ *
+ * Warning: In production, use a proper key derivation from a master seed.
+ */
+export declare function generateShieldedKeys(): ShieldedKeys;
+/**
+ * Restore shielded keys from spending key
+ */
+export declare function shieldedKeysFromSpendingKey(spendingKey: Bytes32): ShieldedKeys;
+/**
+ * Create a new note with random blinding
+ */
+export declare function createNote(value: bigint, ownerPk: Bytes32, position?: bigint): Note;
+/**
+ * Create a note with explicit randomness (for testing/recovery)
+ */
+export declare function noteWithRandomness(value: bigint, ownerPk: Bytes32, randomness: Bytes32, position?: bigint): Note;
+/**
+ * Compute commitment for a note
+ *
+ * commitment = Hash(value || randomness || owner_pk)
+ *
+ * Note: Rust uses Poseidon hash - this uses SHA-512 for simplicity.
+ * For production, this should match the circuit's hash function.
+ */
+export declare function computeCommitment(note: Note): Bytes32;
+/**
+ * Derive nullifier for spending a note
+ *
+ * nullifier = Hash(nk || commitment || position)
+ *
+ * Requires the note to have a position set.
+ */
+export declare function computeNullifier(note: Note, spendingKey: Bytes32): Bytes32 | null;
+/**
+ * ShieldedTransactionBuilder helps construct shielded transactions
+ */
+export declare class ShieldedTransactionBuilder {
+    private inputs;
+    private outputs;
+    private merkleRoot;
+    /**
+     * Add an input (note to spend)
+     */
+    addInput(input: ShieldedInput): this;
+    /**
+     * Add an output (note to create)
+     */
+    addOutput(output: ShieldedOutput): this;
+    /**
+     * Set the merkle root being referenced
+     */
+    setMerkleRoot(root: Bytes32): this;
+    /**
+     * Validate the transaction
+     * - Sum of inputs must equal sum of outputs
+     * - All inputs must have positions
+     * - Merkle root must be set
+     */
+    validate(): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Prepare the transaction for proving
+     *
+     * Returns all the data needed to generate a ZK proof.
+     */
+    prepare(): PreparedShieldedTx;
+    /**
+     * Clear the builder for reuse
+     */
+    clear(): this;
+}
+/**
+ * Scan encrypted notes for ones belonging to a viewing key
+ *
+ * This is used by wallets to find owned notes.
+ */
+export interface ScanResult {
+    /** Position in the commitment tree */
+    position: bigint;
+    /** Decrypted note */
+    note: Note;
+    /** Commitment (for verification) */
+    commitment: Bytes32;
+    /** Decrypted memo */
+    memo?: Uint8Array;
+}
+/**
+ * Try to decrypt an encrypted note
+ *
+ * Returns the note if decryption succeeds, null otherwise.
+ *
+ * Note: This is a placeholder - real implementation needs the
+ * recipient's X25519 secret key for ECDH.
+ */
+export declare function tryDecryptNote(encrypted: EncryptedNote, viewingKey: Bytes32, ownerPk: Bytes32, position: bigint): Note | null;
+export declare const shielded: {
+    generateKeys: typeof generateShieldedKeys;
+    keysFromSpendingKey: typeof shieldedKeysFromSpendingKey;
+    createNote: typeof createNote;
+    noteWithRandomness: typeof noteWithRandomness;
+    computeCommitment: typeof computeCommitment;
+    computeNullifier: typeof computeNullifier;
+    TransactionBuilder: typeof ShieldedTransactionBuilder;
+};
+//# sourceMappingURL=shielded.d.ts.map

package/dist/shielded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shielded.d.ts","sourceRoot":"","sources":["../src/shielded.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Zelana SDK Type Definitions
+ *
+ * These types mirror the Rust API types in core/src/api/types.rs
+ */
+/** 32-byte array represented as Uint8Array */
+export type Bytes32 = Uint8Array;
+/** Account state on L2 */
+export interface AccountState {
+    accountId: string;
+    balance: bigint;
+    nonce: bigint;
+}
+/** Transaction type enumeration */
+export type TxType = 'deposit' | 'transfer' | 'shielded' | 'withdrawal';
+/** Transaction status */
+export type TxStatus = 'pending' | 'included' | 'executed' | 'settled' | 'failed';
+/** Batch status */
+export type BatchStatus = 'building' | 'proving' | 'pending_settlement' | 'settled' | 'failed';
+/** Transaction summary */
+export interface TxSummary {
+    txHash: string;
+    txType: TxType;
+    batchId?: bigint;
+    status: TxStatus;
+    receivedAt: bigint;
+    executedAt?: bigint;
+    amount?: bigint;
+    from?: string;
+    to?: string;
+}
+/** Batch summary */
+export interface BatchSummary {
+    batchId: bigint;
+    txCount: number;
+    stateRoot: string;
+    shieldedRoot: string;
+    l1TxSig?: string;
+    status: BatchStatus;
+    createdAt: bigint;
+    settledAt?: bigint;
+}
+/** Transfer request */
+export interface TransferRequest {
+    from: Bytes32;
+    to: Bytes32;
+    amount: bigint;
+    nonce: bigint;
+    chainId: bigint;
+    signature: Uint8Array;
+    signerPubkey: Bytes32;
+}
+/** Transfer response */
+export interface TransferResponse {
+    txHash: string;
+    accepted: boolean;
+    message: string;
+}
+/** Withdrawal request */
+export interface WithdrawRequest {
+    from: Bytes32;
+    toL1Address: Bytes32;
+    amount: bigint;
+    nonce: bigint;
+    signature: Uint8Array;
+    signerPubkey: Bytes32;
+}
+/** Withdrawal response */
+export interface WithdrawResponse {
+    txHash: string;
+    accepted: boolean;
+    estimatedCompletion?: string;
+    message: string;
+}
+/** Withdrawal status */
+export interface WithdrawalStatus {
+    txHash: string;
+    state: string;
+    amount: bigint;
+    toL1Address: string;
+    l1TxSig?: string;
+}
+/** Shielded transaction request */
+export interface ShieldedRequest {
+    proof: Uint8Array;
+    nullifier: Bytes32;
+    commitment: Bytes32;
+    ciphertext: Uint8Array;
+    ephemeralKey: Bytes32;
+}
+/** Shielded transaction response */
+export interface ShieldedResponse {
+    txHash: string;
+    accepted: boolean;
+    position?: number;
+    message: string;
+}
+/** State roots response */
+export interface StateRoots {
+    batchId: bigint;
+    stateRoot: string;
+    shieldedRoot: string;
+    commitmentCount: bigint;
+}
+/** Batch status response */
+export interface BatchStatusInfo {
+    currentBatchId: bigint;
+    currentBatchTxs: number;
+    provingCount: number;
+    pendingSettlement: number;
+}
+/** Health response */
+export interface HealthInfo {
+    healthy: boolean;
+    version: string;
+    uptimeSecs: bigint;
+}
+/** Global statistics */
+export interface GlobalStats {
+    totalBatches: bigint;
+    totalTransactions: bigint;
+    totalDeposited: bigint;
+    totalWithdrawn: bigint;
+    currentBatchId: bigint;
+    activeAccounts: bigint;
+    shieldedCommitments: bigint;
+    uptimeSecs: bigint;
+}
+/** Fast withdrawal quote */
+export interface FastWithdrawQuote {
+    available: boolean;
+    amount: bigint;
+    fee: bigint;
+    amountReceived: bigint;
+    feeBps: number;
+    lpAddress?: string;
+}
+/** Committee member info */
+export interface CommitteeMemberInfo {
+    id: number;
+    publicKey: string;
+    endpoint?: string;
+}
+/** Committee info */
+export interface CommitteeInfo {
+    enabled: boolean;
+    threshold: number;
+    totalMembers: number;
+    epoch: bigint;
+    members: CommitteeMemberInfo[];
+    pendingCount: number;
+}
+/** Merkle path response */
+export interface MerklePath {
+    position: number;
+    path: string[];
+    root: string;
+}
+/** Scanned note */
+export interface ScannedNote {
+    position: number;
+    commitment: string;
+    value: bigint;
+    memo?: string;
+}
+/** Pagination parameters */
+export interface PaginationParams {
+    offset?: number;
+    limit?: number;
+}
+/** Paginated response */
+export interface PaginatedResponse<T> {
+    items: T[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+/** API error response */
+export interface ApiError {
+    error: string;
+    code: string;
+}
+/** SDK error class */
+export declare class ZelanaError extends Error {
+    code: string;
+    cause?: unknown | undefined;
+    constructor(message: string, code: string, cause?: unknown | undefined);
+}
+/** Dev deposit request - simulates L1 deposit without real indexer */
+export interface DevDepositRequest {
+    /** Recipient account (hex-encoded 32-byte public key) */
+    to: string;
+    /** Amount in lamports */
+    amount: bigint;
+}
+/** Dev deposit response */
+export interface DevDepositResponse {
+    /** Transaction hash */
+    txHash: string;
+    /** Whether the deposit was accepted */
+    accepted: boolean;
+    /** New balance after deposit */
+    newBalance: bigint;
+    /** Status message */
+    message: string;
+}
+/** Dev seal request - forces current batch to seal */
+export interface DevSealRequest {
+    /** Whether to wait for proof generation (default: false) */
+    waitForProof?: boolean;
+}
+/** Dev seal response */
+export interface DevSealResponse {
+    /** Sealed batch ID */
+    batchId: bigint;
+    /** Number of transactions in the sealed batch */
+    txCount: number;
+    /** Status message */
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Utility functions for encoding, hashing, and byte manipulation
+ */
+/**
+ * Convert bytes to hex string
+ */
+export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Convert hex string to bytes
+ */
+export declare function hexToBytes(hex: string): Uint8Array;
+/**
+ * Encode bytes to base58 string
+ */
+export declare function bytesToBase58(bytes: Uint8Array): string;
+/**
+ * Decode base58 string to bytes
+ */
+export declare function base58ToBytes(str: string): Uint8Array;
+/**
+ * Encode u64 as little-endian bytes
+ */
+export declare function u64ToLeBytes(value: bigint): Uint8Array;
+/**
+ * Decode little-endian bytes to u64
+ */
+export declare function leBytesToU64(bytes: Uint8Array): bigint;
+/**
+ * Encode u32 as little-endian bytes
+ */
+export declare function u32ToLeBytes(value: number): Uint8Array;
+/**
+ * Concatenate multiple Uint8Arrays
+ */
+export declare function concatBytes(...arrays: Uint8Array[]): Uint8Array;
+/**
+ * Check if two byte arrays are equal
+ */
+export declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+/**
+ * Create a zero-filled Uint8Array of specified length
+ */
+export declare function zeroBytes(length: number): Uint8Array;
+/**
+ * Generate random bytes
+ */
+export declare function randomBytes(length: number): Uint8Array;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAOpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAiBlD;AAYD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAuCvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAyCrD;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAMtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAStD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAOtD;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAS/D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAMhE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAWtD"}