@rougechain/sdk 0.4.1 → 0.6.0

package/dist/index.d.ts

@@ -0,0 +1,765 @@
+interface WalletKeys {
+    publicKey: string;
+    privateKey: string;
+}
+interface ApiResponse<T = unknown> {
+    success: boolean;
+    error?: string;
+    data?: T;
+}
+type TransactionType = "transfer" | "create_token" | "swap" | "create_pool" | "add_liquidity" | "remove_liquidity" | "stake" | "unstake" | "faucet" | "nft_create_collection" | "nft_mint" | "nft_batch_mint" | "nft_transfer" | "nft_burn" | "nft_lock" | "nft_freeze_collection" | "bridge_withdraw" | "update_token_metadata" | "claim_token_metadata" | "shield" | "shielded_transfer" | "unshield";
+interface TransactionPayload {
+    type: TransactionType;
+    from: string;
+    to?: string;
+    amount?: number;
+    fee?: number;
+    token?: string;
+    tokenSymbol?: string;
+    evmAddress?: string;
+    timestamp: number;
+    nonce: string;
+    token_name?: string;
+    token_symbol?: string;
+    initial_supply?: number;
+    token_in?: string;
+    token_out?: string;
+    amount_in?: number;
+    min_amount_out?: number;
+    pool_id?: string;
+    token_a?: string;
+    token_b?: string;
+    amount_a?: number;
+    amount_b?: number;
+    lp_amount?: number;
+    symbol?: string;
+    name?: string;
+    collectionId?: string;
+    description?: string;
+    image?: string;
+    maxSupply?: number;
+    royaltyBps?: number;
+    tokenId?: number;
+    metadataUri?: string;
+    attributes?: unknown;
+    locked?: boolean;
+    frozen?: boolean;
+    salePrice?: number;
+    names?: string[];
+    uris?: string[];
+    batchAttributes?: unknown[];
+    website?: string;
+    twitter?: string;
+    discord?: string;
+}
+interface SignedTransaction {
+    payload: TransactionPayload;
+    signature: string;
+    public_key: string;
+}
+interface BlockHeader {
+    version: number;
+    chain_id: string;
+    height: number;
+    time: number;
+    prev_hash: string;
+    tx_hash: string;
+    proposer_pub_key: string;
+}
+interface Transaction {
+    version: number;
+    tx_type: string;
+    from_pub_key: string;
+    target_pub_key?: string | null;
+    amount: number;
+    fee: number;
+    sig: string;
+    token_name?: string | null;
+    token_symbol?: string | null;
+    token_decimals?: number | null;
+    token_total_supply?: number | null;
+    pool_id?: string | null;
+    token_a_symbol?: string | null;
+    token_b_symbol?: string | null;
+    amount_a?: number | null;
+    amount_b?: number | null;
+    min_amount_out?: number | null;
+    swap_path?: string[] | null;
+    lp_amount?: number | null;
+    faucet?: boolean;
+    signed_payload?: string | null;
+}
+interface Block {
+    version: number;
+    header: BlockHeader;
+    txs: Transaction[];
+    proposer_sig: string;
+    hash: string;
+}
+interface NodeStats {
+    height: number;
+    peers: number;
+    network_height: number;
+    mining: boolean;
+    total_fees: number;
+    last_block_fees: number;
+    finalized_height: number;
+    ws_clients: number;
+}
+interface TokenMetadata {
+    symbol: string;
+    name: string;
+    creator: string;
+    image?: string;
+    description?: string;
+    website?: string;
+    twitter?: string;
+    discord?: string;
+    created_at: number;
+    updated_at: number;
+}
+interface TokenHolder {
+    address: string;
+    balance: number;
+}
+interface BalanceResponse {
+    balance: number;
+    token_balances: Record<string, number>;
+    lp_balances: Record<string, number>;
+}
+interface LiquidityPool {
+    pool_id: string;
+    token_a_symbol: string;
+    token_b_symbol: string;
+    reserve_a: number;
+    reserve_b: number;
+    total_lp: number;
+    fee_rate: number;
+    created_at: number;
+}
+interface SwapQuote {
+    amount_out: number;
+    price_impact: number;
+    path: string[];
+}
+interface PoolEvent {
+    event_type: string;
+    pool_id: string;
+    actor: string;
+    token_a_amount?: number;
+    token_b_amount?: number;
+    lp_amount?: number;
+    timestamp: number;
+}
+interface PoolStats {
+    pool_id: string;
+    volume_24h: number;
+    trades_24h: number;
+    tvl: number;
+}
+interface PriceSnapshot {
+    pool_id: string;
+    timestamp: number;
+    block_height: number;
+    reserve_a: number;
+    reserve_b: number;
+    price_a_in_b: number;
+    price_b_in_a: number;
+}
+interface NftCollection {
+    collection_id: string;
+    symbol: string;
+    name: string;
+    creator: string;
+    description?: string;
+    image?: string;
+    max_supply?: number;
+    minted: number;
+    royalty_bps: number;
+    royalty_recipient: string;
+    frozen: boolean;
+    created_at: number;
+}
+interface NftToken {
+    collection_id: string;
+    token_id: number;
+    owner: string;
+    creator: string;
+    name: string;
+    metadata_uri?: string;
+    attributes?: unknown;
+    locked: boolean;
+    minted_at: number;
+    transferred_at: number;
+}
+interface Validator {
+    public_key: string;
+    stake: number;
+    status: string;
+    jailed_until: number;
+    uptime: number;
+}
+interface BridgeConfig {
+    enabled: boolean;
+    custodyAddress?: string;
+    chainId: number;
+    supportedTokens?: string[];
+}
+interface BridgeWithdrawal {
+    tx_id: string;
+    from_pub_key: string;
+    evm_address: string;
+    amount_units: number;
+    status: string;
+    created_at: number;
+}
+interface XrgeBridgeConfig {
+    enabled: boolean;
+    vaultAddress?: string;
+    tokenAddress?: string;
+    chainId: number;
+}
+interface MailMessage {
+    id: string;
+    from: string;
+    to: string;
+    subject: string;
+    body: string;
+    encrypted_subject?: string;
+    encrypted_body?: string;
+    reply_to_id?: string;
+    read: boolean;
+    folder: "inbox" | "sent" | "trash";
+    created_at: number;
+}
+interface SendMailParams {
+    from: string;
+    to: string;
+    subject: string;
+    body: string;
+    encrypted_subject: string;
+    encrypted_body: string;
+    reply_to_id?: string;
+}
+interface MessengerWallet {
+    id: string;
+    displayName: string;
+    signingPublicKey: string;
+    encryptionPublicKey: string;
+    created_at: number;
+}
+interface MessengerConversation {
+    id: string;
+    participants: string[];
+    created_at: number;
+    last_message_at?: string;
+    last_sender_id?: string;
+    last_message_preview?: string;
+    unread_count?: number;
+}
+interface MessengerMessage {
+    id: string;
+    conversation_id: string;
+    sender: string;
+    encrypted_content: string;
+    media_type?: string;
+    media_data?: string;
+    self_destruct?: boolean;
+    destruct_after_seconds?: number;
+    read?: boolean;
+    created_at: number;
+}
+interface TransferParams {
+    to: string;
+    amount: number;
+    fee?: number;
+    token?: string;
+}
+interface CreateTokenParams {
+    name: string;
+    symbol: string;
+    totalSupply: number;
+    fee?: number;
+    /** Token logo — URL or data URI (base64). Stored on-chain in token metadata. */
+    image?: string;
+}
+interface SwapParams {
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: number;
+    minAmountOut: number;
+}
+interface CreatePoolParams {
+    tokenA: string;
+    tokenB: string;
+    amountA: number;
+    amountB: number;
+}
+interface AddLiquidityParams {
+    poolId: string;
+    amountA: number;
+    amountB: number;
+}
+interface RemoveLiquidityParams {
+    poolId: string;
+    lpAmount: number;
+}
+interface StakeParams {
+    amount: number;
+    fee?: number;
+}
+interface CreateNftCollectionParams {
+    symbol: string;
+    name: string;
+    maxSupply?: number;
+    royaltyBps?: number;
+    image?: string;
+    description?: string;
+}
+interface MintNftParams {
+    collectionId: string;
+    name: string;
+    metadataUri?: string;
+    attributes?: unknown;
+}
+interface BatchMintNftParams {
+    collectionId: string;
+    names: string[];
+    uris?: string[];
+    batchAttributes?: unknown[];
+}
+interface TransferNftParams {
+    collectionId: string;
+    tokenId: number;
+    to: string;
+    salePrice?: number;
+}
+interface BurnNftParams {
+    collectionId: string;
+    tokenId: number;
+}
+interface LockNftParams {
+    collectionId: string;
+    tokenId: number;
+    locked: boolean;
+}
+interface FreezeCollectionParams {
+    collectionId: string;
+    frozen: boolean;
+}
+interface BridgeWithdrawParams {
+    amount: number;
+    evmAddress: string;
+    fee?: number;
+    tokenSymbol?: string;
+}
+interface BridgeClaimParams {
+    evmTxHash: string;
+    evmAddress: string;
+    evmSignature: string;
+    recipientPubkey: string;
+    token?: "ETH" | "USDC";
+}
+interface XrgeBridgeClaimParams {
+    evmTxHash: string;
+    evmAddress: string;
+    amount: string;
+    recipientPubkey: string;
+}
+interface XrgeBridgeWithdrawParams {
+    amount: number;
+    evmAddress: string;
+}
+interface SwapQuoteParams {
+    poolId: string;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: number;
+}
+interface TokenMetadataUpdateParams {
+    symbol: string;
+    image?: string;
+    description?: string;
+    website?: string;
+    twitter?: string;
+    discord?: string;
+}
+interface ShieldParams {
+    /** Amount to shield (integer XRGE) */
+    amount: number;
+}
+interface ShieldedTransferParams {
+    /** Nullifiers of consumed input notes (hex) */
+    nullifiers: string[];
+    /** Commitments for output notes (hex) */
+    outputCommitments: string[];
+    /** STARK proof bytes (hex) */
+    proof: string;
+    /** Fee paid from the shielded pool */
+    shieldedFee?: number;
+}
+interface UnshieldParams {
+    /** Nullifiers of consumed notes (hex) */
+    nullifiers: string[];
+    /** Amount to unshield (integer XRGE) */
+    amount: number;
+    /** STARK proof bytes (hex) */
+    proof: string;
+}
+interface ShieldedStats {
+    success: boolean;
+    commitment_count: number;
+    nullifier_count: number;
+    active_notes: number;
+}
+interface RollupStatus {
+    pending_transfers: number;
+    completed_batches: number;
+    next_batch_id: number;
+    max_batch_size: number;
+    batch_timeout_secs: number;
+    current_state_root: string;
+    accounts_tracked: number;
+}
+interface RollupBatchResult {
+    batch_id: number;
+    transfer_count: number;
+    total_fees: number;
+    pre_state_root: string;
+    post_state_root: string;
+    proof_size_bytes: number;
+    proof_time_ms: number;
+    verified: boolean;
+}
+interface RollupSubmitParams {
+    sender: string;
+    receiver: string;
+    amount: number;
+    fee?: number;
+}
+interface RollupSubmitResult {
+    success: boolean;
+    queued: boolean;
+    batch_completed: boolean;
+    batch?: RollupBatchResult;
+    pending_transfers?: number;
+    max_batch_size?: number;
+}
+
+/**
+ * Client-side shielded transaction crypto primitives.
+ *
+ * Mirrors the Rust commitment.rs exactly:
+ *   commitment = SHA-256("ROUGECHAIN_COMMITMENT_V1" || value || pubkey || randomness)
+ *   nullifier  = SHA-256("ROUGECHAIN_NULLIFIER_V1"  || randomness || commitment)
+ */
+/** Generate 32 bytes of cryptographically secure randomness (hex-encoded). */
+declare function generateRandomness(): string;
+/**
+ * Compute a shielded note commitment.
+ *
+ * @param value       - Note value in XRGE (integer)
+ * @param ownerPubKey - Owner's ML-DSA-65 public key (hex)
+ * @param randomness  - 32-byte blinding factor (hex)
+ * @returns 32-byte commitment hash (hex)
+ */
+declare function computeCommitment(value: number, ownerPubKey: string, randomness: string): string;
+/**
+ * Compute a nullifier for a shielded note.
+ *
+ * @param randomness - The note's blinding factor (hex)
+ * @param commitment - The note's commitment hash (hex)
+ * @returns 32-byte nullifier hash (hex)
+ */
+declare function computeNullifier(randomness: string, commitment: string): string;
+/** A shielded note — kept locally by the owner (never sent to chain). */
+interface ShieldedNote {
+    commitment: string;
+    nullifier: string;
+    value: number;
+    randomness: string;
+    ownerPubKey: string;
+}
+/**
+ * Create a new shielded note for a given value.
+ *
+ * @param value       - XRGE amount (integer)
+ * @param ownerPubKey - Owner's public key (hex)
+ * @returns A ShieldedNote with all derived fields
+ */
+declare function createShieldedNote(value: number, ownerPubKey: string): ShieldedNote;
+
+type FetchFn = typeof globalThis.fetch;
+interface RougeChainOptions {
+    /** Custom fetch implementation (defaults to globalThis.fetch) */
+    fetch?: FetchFn;
+    /** Optional API key for authenticated endpoints */
+    apiKey?: string;
+}
+declare class RougeChain {
+    /** @internal */ readonly baseUrl: string;
+    /** @internal */ readonly fetchFn: FetchFn;
+    /** @internal */ readonly headers: Record<string, string>;
+    readonly nft: NftClient;
+    readonly dex: DexClient;
+    readonly bridge: BridgeClient;
+    readonly mail: MailClient;
+    readonly messenger: MessengerClient;
+    readonly shielded: ShieldedClient;
+    constructor(baseUrl: string, options?: RougeChainOptions);
+    /** @internal */
+    get<T = unknown>(path: string): Promise<T>;
+    /** @internal */
+    post<T = unknown>(path: string, body: unknown): Promise<T>;
+    /** @internal */
+    submitTx(endpoint: string, signedTx: SignedTransaction): Promise<ApiResponse>;
+    getStats(): Promise<NodeStats>;
+    getHealth(): Promise<{
+        status: string;
+        chain_id: string;
+        height: number;
+    }>;
+    getBlocks(opts?: {
+        limit?: number;
+    }): Promise<Block[]>;
+    getBlocksSummary(range?: "1h" | "24h" | "7d"): Promise<unknown>;
+    getBalance(publicKey: string): Promise<BalanceResponse>;
+    getTokenBalance(publicKey: string, token: string): Promise<number>;
+    getTransactions(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    getTokens(): Promise<TokenMetadata[]>;
+    getTokenMetadata(symbol: string): Promise<TokenMetadata>;
+    getTokenHolders(symbol: string): Promise<TokenHolder[]>;
+    getTokenTransactions(symbol: string): Promise<unknown>;
+    getValidators(): Promise<Validator[]>;
+    getValidatorStats(): Promise<unknown>;
+    getFinality(): Promise<{
+        finalized_height: number;
+        tip_height: number;
+        total_stake: number;
+        finalized_stake: number;
+    }>;
+    getPeers(): Promise<string[]>;
+    getBurnedTokens(): Promise<{
+        burned: Record<string, number>;
+        total_xrge_burned: number;
+    }>;
+    transfer(wallet: WalletKeys, params: TransferParams): Promise<ApiResponse>;
+    createToken(wallet: WalletKeys, params: CreateTokenParams): Promise<ApiResponse>;
+    stake(wallet: WalletKeys, params: StakeParams): Promise<ApiResponse>;
+    unstake(wallet: WalletKeys, params: StakeParams): Promise<ApiResponse>;
+    faucet(wallet: WalletKeys): Promise<ApiResponse>;
+    burn(wallet: WalletKeys, amount: number, fee?: number, token?: string): Promise<ApiResponse>;
+    updateTokenMetadata(wallet: WalletKeys, params: TokenMetadataUpdateParams): Promise<ApiResponse>;
+    claimTokenMetadata(wallet: WalletKeys, tokenSymbol: string): Promise<ApiResponse>;
+    /** Get the current rollup accumulator status. */
+    getRollupStatus(): Promise<RollupStatus>;
+    /** Submit a transfer into the rollup batch accumulator. */
+    submitRollupTransfer(params: RollupSubmitParams): Promise<RollupSubmitResult>;
+    /** Get the result of a completed rollup batch by ID. */
+    getRollupBatch(batchId: number): Promise<RollupBatchResult>;
+}
+declare class NftClient {
+    private readonly rc;
+    constructor(rc: RougeChain);
+    getCollections(): Promise<NftCollection[]>;
+    getCollection(collectionId: string): Promise<NftCollection>;
+    /**
+     * Poll until a collection exists on-chain (i.e. the create tx has been mined).
+     * Useful after `createCollection` since the tx goes to the mempool first.
+     * @returns the collection once found, or throws after the timeout.
+     */
+    waitForCollection(collectionId: string, opts?: {
+        timeoutMs?: number;
+        pollMs?: number;
+    }): Promise<NftCollection>;
+    getTokens(collectionId: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        tokens: NftToken[];
+        total: number;
+    }>;
+    getToken(collectionId: string, tokenId: number): Promise<NftToken>;
+    getByOwner(pubkey: string): Promise<NftToken[]>;
+    createCollection(wallet: WalletKeys, params: CreateNftCollectionParams): Promise<ApiResponse>;
+    mint(wallet: WalletKeys, params: MintNftParams): Promise<ApiResponse>;
+    batchMint(wallet: WalletKeys, params: BatchMintNftParams): Promise<ApiResponse>;
+    transfer(wallet: WalletKeys, params: TransferNftParams): Promise<ApiResponse>;
+    burn(wallet: WalletKeys, params: BurnNftParams): Promise<ApiResponse>;
+    lock(wallet: WalletKeys, params: LockNftParams): Promise<ApiResponse>;
+    freezeCollection(wallet: WalletKeys, params: FreezeCollectionParams): Promise<ApiResponse>;
+}
+declare class DexClient {
+    private readonly rc;
+    constructor(rc: RougeChain);
+    getPools(): Promise<LiquidityPool[]>;
+    getPool(poolId: string): Promise<LiquidityPool>;
+    getPoolEvents(poolId: string): Promise<PoolEvent[]>;
+    getPriceHistory(poolId: string): Promise<PriceSnapshot[]>;
+    getPoolStats(poolId: string): Promise<PoolStats>;
+    quote(params: SwapQuoteParams): Promise<SwapQuote>;
+    swap(wallet: WalletKeys, params: SwapParams): Promise<ApiResponse>;
+    createPool(wallet: WalletKeys, params: CreatePoolParams): Promise<ApiResponse>;
+    addLiquidity(wallet: WalletKeys, params: AddLiquidityParams): Promise<ApiResponse>;
+    removeLiquidity(wallet: WalletKeys, params: RemoveLiquidityParams): Promise<ApiResponse>;
+}
+declare class BridgeClient {
+    private readonly rc;
+    constructor(rc: RougeChain);
+    getConfig(): Promise<BridgeConfig>;
+    getWithdrawals(): Promise<BridgeWithdrawal[]>;
+    /** Withdraw qETH/qUSDC — signed client-side, private key never sent to server */
+    withdraw(wallet: WalletKeys, params: BridgeWithdrawParams): Promise<ApiResponse>;
+    /** Claim qETH or qUSDC after depositing on Base Sepolia */
+    claim(params: BridgeClaimParams): Promise<ApiResponse>;
+    getXrgeConfig(): Promise<XrgeBridgeConfig>;
+    claimXrge(params: XrgeBridgeClaimParams): Promise<ApiResponse>;
+    withdrawXrge(wallet: WalletKeys, params: XrgeBridgeWithdrawParams): Promise<ApiResponse>;
+    getXrgeWithdrawals(): Promise<BridgeWithdrawal[]>;
+}
+declare class MailClient {
+    private readonly rc;
+    constructor(rc: RougeChain);
+    send(params: SendMailParams): Promise<ApiResponse>;
+    getInbox(walletId: string): Promise<MailMessage[]>;
+    getSent(walletId: string): Promise<MailMessage[]>;
+    getTrash(walletId: string): Promise<MailMessage[]>;
+    getMessage(id: string): Promise<MailMessage>;
+    move(messageId: string, folder: string): Promise<ApiResponse>;
+    markRead(messageId: string): Promise<ApiResponse>;
+    delete(id: string): Promise<ApiResponse>;
+}
+declare class MessengerClient {
+    private readonly rc;
+    constructor(rc: RougeChain);
+    getWallets(): Promise<MessengerWallet[]>;
+    registerWallet(opts: {
+        id: string;
+        displayName: string;
+        signingPublicKey: string;
+        encryptionPublicKey: string;
+    }): Promise<ApiResponse>;
+    getConversations(walletId: string, opts?: {
+        signingPublicKey?: string;
+        encryptionPublicKey?: string;
+    }): Promise<MessengerConversation[]>;
+    createConversation(participants: string[]): Promise<ApiResponse>;
+    getMessages(conversationId: string): Promise<MessengerMessage[]>;
+    sendMessage(conversationId: string, sender: string, encryptedContent: string, opts?: {
+        mediaType?: string;
+        mediaData?: string;
+        selfDestruct?: boolean;
+        destructAfterSeconds?: number;
+    }): Promise<ApiResponse>;
+    deleteMessage(messageId: string): Promise<ApiResponse>;
+    markRead(messageId: string): Promise<ApiResponse>;
+}
+declare class ShieldedClient {
+    private readonly rc;
+    constructor(rc: RougeChain);
+    getStats(): Promise<ShieldedStats>;
+    isNullifierSpent(nullifierHex: string): Promise<{
+        spent: boolean;
+    }>;
+    /**
+     * Shield public XRGE into a private note.
+     * Creates the commitment client-side, submits to the chain.
+     *
+     * @returns The ShieldedNote (keep this locally — it's the only way to spend the note)
+     */
+    shield(wallet: WalletKeys, params: ShieldParams): Promise<ApiResponse & {
+        note?: ShieldedNote;
+    }>;
+    /**
+     * Transfer between shielded notes (private → private).
+     * Requires a pre-generated STARK proof.
+     */
+    transfer(wallet: WalletKeys, params: ShieldedTransferParams): Promise<ApiResponse>;
+    /**
+     * Unshield a private note back to public XRGE.
+     * Requires a STARK proof of note ownership.
+     */
+    unshield(wallet: WalletKeys, params: UnshieldParams): Promise<ApiResponse>;
+}
+
+declare class Wallet implements WalletKeys {
+    readonly publicKey: string;
+    readonly privateKey: string;
+    private constructor();
+    /**
+     * Generate a new ML-DSA-65 keypair.
+     * Uses crypto.getRandomValues for secure randomness.
+     */
+    static generate(): Wallet;
+    /**
+     * Restore a wallet from existing hex-encoded keys.
+     */
+    static fromKeys(publicKey: string, privateKey: string): Wallet;
+    /**
+     * Export keys as a plain object (for serialization/storage).
+     */
+    toJSON(): WalletKeys;
+    /**
+     * Derive the compact Bech32m address from the public key.
+     * Returns a ~63-character `rouge1...` string.
+     */
+    address(): Promise<string>;
+    /**
+     * Verify that the keypair is valid by signing and verifying a test message.
+     */
+    verify(): boolean;
+}
+
+declare const BURN_ADDRESS = "XRGE_BURN_0x000000000000000000000000000000000000000000000000000000000000DEAD";
+declare function serializePayload(payload: TransactionPayload): Uint8Array;
+declare function signTransaction(payload: TransactionPayload, privateKey: string, publicKey: string): SignedTransaction;
+declare function verifyTransaction(signedTx: SignedTransaction): boolean;
+declare function isBurnAddress(address: string): boolean;
+declare function createSignedTokenMetadataUpdate(wallet: WalletKeys, tokenSymbol: string, metadata: {
+    image?: string;
+    description?: string;
+    website?: string;
+    twitter?: string;
+    discord?: string;
+}): SignedTransaction;
+declare function createSignedTokenMetadataClaim(wallet: WalletKeys, tokenSymbol: string): SignedTransaction;
+declare function createSignedBridgeWithdraw(wallet: WalletKeys, amount: number, evmAddress: string, tokenSymbol?: string, fee?: number): SignedTransaction;
+declare function createSignedShield(wallet: WalletKeys, amount: number, commitment: string): SignedTransaction;
+declare function createSignedShieldedTransfer(wallet: WalletKeys, nullifiers: string[], outputCommitments: string[], proof: string, shieldedFee?: number): SignedTransaction;
+declare function createSignedUnshield(wallet: WalletKeys, nullifiers: string[], amount: number, proof: string): SignedTransaction;
+
+declare function hexToBytes(hex: string): Uint8Array;
+declare function bytesToHex(bytes: Uint8Array): string;
+declare function generateNonce(): string;
+
+/**
+ * RougeChain Bech32m Address Utilities for SDK
+ *
+ * Derives compact, human-readable addresses from PQC public keys:
+ *   address = bech32m("rouge", SHA-256(raw_pubkey_bytes))
+ *
+ * Result: ~63-char address like "rouge1q8f3x7k2m4n9p..."
+ * Matches the Rust implementation in core/crypto/src/lib.rs exactly.
+ */
+/**
+ * Derive a compact Bech32m address from an ML-DSA-65 public key (hex).
+ * Returns a ~63-character string like "rouge1q8f3x7k2m4n9p..."
+ */
+declare function pubkeyToAddress(publicKeyHex: string): Promise<string>;
+/**
+ * Decode a Bech32m address back to its 32-byte SHA-256 hash (hex).
+ */
+declare function addressToHash(address: string): string;
+/**
+ * Check if a string is a valid RougeChain Bech32m address.
+ */
+declare function isRougeAddress(input: string): boolean;
+/**
+ * Format an address for compact display: "rouge1q8f3...k9m2"
+ */
+declare function formatAddress(address: string, prefixLen?: number, suffixLen?: number): string;
+
+export { type AddLiquidityParams, type ApiResponse, BURN_ADDRESS, type BalanceResponse, type BatchMintNftParams, type Block, type BlockHeader, type BridgeClaimParams, type BridgeConfig, type BridgeWithdrawParams, type BridgeWithdrawal, type BurnNftParams, type CreateNftCollectionParams, type CreatePoolParams, type CreateTokenParams, type FreezeCollectionParams, type LiquidityPool, type LockNftParams, type MailMessage, type MessengerConversation, type MessengerMessage, type MessengerWallet, type MintNftParams, type NftCollection, type NftToken, type NodeStats, type PoolEvent, type PoolStats, type PriceSnapshot, type RemoveLiquidityParams, type RollupBatchResult, type RollupStatus, type RollupSubmitParams, type RollupSubmitResult, RougeChain, type RougeChainOptions, type SendMailParams, type ShieldParams, type ShieldedNote, type ShieldedStats, type ShieldedTransferParams, type SignedTransaction, type StakeParams, type SwapParams, type SwapQuote, type SwapQuoteParams, type TokenHolder, type TokenMetadata, type TokenMetadataUpdateParams, type Transaction, type TransactionPayload, type TransactionType, type TransferNftParams, type TransferParams, type UnshieldParams, type Validator, Wallet, type WalletKeys, type XrgeBridgeClaimParams, type XrgeBridgeConfig, type XrgeBridgeWithdrawParams, addressToHash, bytesToHex, computeCommitment, computeNullifier, createShieldedNote, createSignedBridgeWithdraw, createSignedShield, createSignedShieldedTransfer, createSignedTokenMetadataClaim, createSignedTokenMetadataUpdate, createSignedUnshield, formatAddress, generateNonce, generateRandomness, hexToBytes, isBurnAddress, isRougeAddress, pubkeyToAddress, serializePayload, signTransaction, verifyTransaction };