@zelana/sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Zelana API Client
+ *
+ * Low-level HTTP client for the Zelana L2 sequencer API.
+ * Handles request/response serialization and error handling.
+ */
+import type { Bytes32, AccountState, TransferRequest, TransferResponse, WithdrawRequest, WithdrawResponse, WithdrawalStatus, ShieldedRequest, ShieldedResponse, StateRoots, BatchStatusInfo, HealthInfo, GlobalStats, FastWithdrawQuote, CommitteeInfo, MerklePath, ScannedNote, TxSummary, BatchSummary, PaginationParams, DevDepositResponse, DevSealResponse } from './types';
+/**
+ * API client configuration
+ */
+export interface ApiClientConfig {
+    /** Base URL of the sequencer API (e.g., "http://localhost:3000") */
+    baseUrl: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Custom fetch implementation (for Node.js compatibility) */
+    fetch?: typeof fetch;
+}
+/**
+ * Low-level API client for Zelana L2 sequencer
+ */
+export declare class ApiClient {
+    private readonly baseUrl;
+    private readonly timeout;
+    private readonly fetch;
+    constructor(config: ApiClientConfig);
+    private request;
+    private get;
+    private post;
+    /**
+     * Check if the sequencer is healthy
+     */
+    health(): Promise<HealthInfo>;
+    /**
+     * Get current state roots
+     */
+    getStateRoots(): Promise<StateRoots>;
+    /**
+     * Get current batch status
+     */
+    getBatchStatus(): Promise<BatchStatusInfo>;
+    /**
+     * Get global statistics
+     */
+    getStats(): Promise<GlobalStats>;
+    /**
+     * Get account state by ID (hex-encoded public key)
+     */
+    getAccount(accountId: string): Promise<AccountState>;
+    /**
+     * Get account state by public key bytes
+     */
+    getAccountByPubkey(pubkey: Bytes32): Promise<AccountState>;
+    /**
+     * Submit a signed transfer transaction
+     */
+    submitTransfer(request: TransferRequest): Promise<TransferResponse>;
+    /**
+     * Submit a signed withdrawal request
+     */
+    submitWithdrawal(request: WithdrawRequest): Promise<WithdrawResponse>;
+    /**
+     * Get withdrawal status by transaction hash
+     */
+    getWithdrawalStatus(txHash: string): Promise<WithdrawalStatus>;
+    /**
+     * Get fast withdrawal quote
+     */
+    getFastWithdrawQuote(amount: bigint): Promise<FastWithdrawQuote>;
+    /**
+     * Submit a shielded transaction
+     */
+    submitShielded(request: ShieldedRequest): Promise<ShieldedResponse>;
+    /**
+     * Get merkle path for a commitment
+     */
+    getMerklePath(position: number): Promise<MerklePath>;
+    /**
+     * Scan for notes owned by a viewing key
+     */
+    scanNotes(decryptionKey: Bytes32, ownerPk: Bytes32, fromPosition?: number, limit?: number): Promise<{
+        notes: ScannedNote[];
+        scannedTo: number;
+    }>;
+    /**
+     * Get batch by ID
+     */
+    getBatch(batchId: bigint): Promise<BatchSummary | null>;
+    /**
+     * List batches with pagination
+     */
+    listBatches(params?: PaginationParams): Promise<{
+        batches: BatchSummary[];
+        total: number;
+    }>;
+    /**
+     * Get transaction by hash
+     */
+    getTransaction(txHash: string): Promise<TxSummary | null>;
+    /**
+     * List transactions with pagination and filters
+     */
+    listTransactions(params?: PaginationParams & {
+        batchId?: bigint;
+        txType?: string;
+        status?: string;
+    }): Promise<{
+        transactions: TxSummary[];
+        total: number;
+    }>;
+    /**
+     * Get threshold encryption committee info
+     */
+    getCommittee(): Promise<CommitteeInfo>;
+    /**
+     * Simulate a deposit from L1 (DEV MODE ONLY)
+     *
+     * This endpoint is only available when the sequencer is running with DEV_MODE=true.
+     * It bypasses the L1 indexer and directly credits funds to an account.
+     *
+     * @param to - Recipient account (hex-encoded 32-byte public key)
+     * @param amount - Amount to deposit in lamports
+     * @returns Deposit response with new balance
+     * @throws ZelanaError if dev mode is not enabled (404)
+     */
+    devDeposit(to: string, amount: bigint): Promise<DevDepositResponse>;
+    /**
+     * Force seal the current batch (DEV MODE ONLY)
+     *
+     * This endpoint is only available when the sequencer is running with DEV_MODE=true.
+     * It forces the current batch to seal immediately, bypassing the normal seal triggers.
+     *
+     * @param waitForProof - Whether to wait for proof generation (default: false)
+     * @returns Seal response with batch ID and transaction count
+     * @throws ZelanaError if dev mode is not enabled (404)
+     */
+    devSeal(waitForProof?: boolean): Promise<DevSealResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Zelana TypeScript SDK
+ *
+ * Official SDK for interacting with Zelana L2, a privacy-focused Solana rollup.
+ *
+ * @example
+ * ```typescript
+ * import { ZelanaClient, Keypair } from '@zelana/sdk';
+ *
+ * // Generate a new keypair
+ * const keypair = Keypair.generate();
+ * console.log('Public Key:', keypair.publicKeyBase58);
+ *
+ * // Create client
+ * const client = new ZelanaClient({
+ *   baseUrl: 'http://localhost:3000',
+ *   keypair,
+ * });
+ *
+ * // Check health
+ * const healthy = await client.isHealthy();
+ * console.log('Sequencer healthy:', healthy);
+ *
+ * // Get account balance
+ * const balance = await client.getBalance();
+ * console.log('Balance:', balance);
+ *
+ * // Transfer funds
+ * const result = await client.transfer(recipientPubkey, 1_000_000n);
+ * console.log('TX Hash:', result.txHash);
+ *
+ * // Wait for confirmation
+ * await client.waitForTransaction(result.txHash);
+ * console.log('Transfer confirmed!');
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { ZelanaClient } from './zelana';
+export type { ZelanaClientConfig } from './zelana';
+export { Keypair, PublicKey } from './keypair';
+export { ApiClient } from './client';
+export type { ApiClientConfig } from './client';
+export type { Bytes32, AccountState, TxType, TxStatus, TxSummary, BatchStatus, BatchSummary, TransferRequest, TransferResponse, WithdrawRequest, WithdrawResponse, WithdrawalStatus, ShieldedRequest, ShieldedResponse, StateRoots, BatchStatusInfo, HealthInfo, GlobalStats, MerklePath, ScannedNote, FastWithdrawQuote, CommitteeMemberInfo, CommitteeInfo, PaginationParams, PaginatedResponse, DevDepositRequest, DevDepositResponse, DevSealRequest, DevSealResponse, ApiError, } from './types';
+export { ZelanaError } from './types';
+export { shielded, ShieldedTransactionBuilder, generateShieldedKeys, shieldedKeysFromSpendingKey, createNote, noteWithRandomness, computeCommitment, computeNullifier, tryDecryptNote, } from './shielded';
+export type { Note, EncryptedNote, ShieldedKeys, ShieldedInput, ShieldedOutput, PreparedShieldedTx, ShieldedTransaction, ShieldedWitness, ScanResult, MerklePath as ShieldedMerklePath, } from './shielded';
+export { bytesToHex, hexToBytes, bytesToBase58, base58ToBytes, u64ToLeBytes, leBytesToU64, concatBytes, bytesEqual, randomBytes, } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD,YAAY,EAEV,OAAO,EACP,YAAY,EAGZ,MAAM,EACN,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EAGZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAGhB,UAAU,EACV,eAAe,EACf,UAAU,EACV,WAAW,EAGX,UAAU,EACV,WAAW,EAGX,iBAAiB,EAGjB,mBAAmB,EACnB,aAAa,EAGb,gBAAgB,EAChB,iBAAiB,EAGjB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,eAAe,EAGf,QAAQ,GACT,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,oBAAoB,EACpB,2BAA2B,EAC3B,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,UAAU,IAAI,kBAAkB,GACjC,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC"}