@rougechain/sdk 0.1.1 → 0.2.0

package/dist/index.d.cts

@@ -7,7 +7,7 @@ interface ApiResponse<T = unknown> {
     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";
+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";
 interface TransactionPayload {
     type: TransactionType;
     from: string;
@@ -15,6 +15,8 @@ interface TransactionPayload {
     amount?: number;
     fee?: number;
     token?: string;
+    tokenSymbol?: string;
+    evmAddress?: string;
     timestamp: number;
     nonce: string;
     token_name?: string;
@@ -189,6 +191,7 @@ interface BridgeConfig {
     enabled: boolean;
     custodyAddress?: string;
     chainId: number;
+    supportedTokens?: string[];
 }
 interface BridgeWithdrawal {
     tx_id: string;
@@ -198,6 +201,56 @@ interface BridgeWithdrawal {
     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 {
+    wallet_id: string;
+    display_name?: string;
+    encryption_public_key?: string;
+    created_at: number;
+}
+interface MessengerConversation {
+    id: string;
+    participants: string[];
+    created_at: number;
+}
+interface MessengerMessage {
+    id: string;
+    conversation_id: string;
+    sender: string;
+    encrypted_content: string;
+    media_type?: string;
+    media_data?: string;
+    self_destruct?: boolean;
+    read?: boolean;
+    created_at: number;
+}
 interface TransferParams {
     to: string;
     amount: number;
@@ -278,6 +331,24 @@ 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;
@@ -301,12 +372,14 @@ interface RougeChainOptions {
     apiKey?: string;
 }
 declare class RougeChain {
-    private readonly baseUrl;
-    private readonly fetchFn;
-    private readonly headers;
+    /** @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;
     constructor(baseUrl: string, options?: RougeChainOptions);
     /** @internal */
     get<T = unknown>(path: string): Promise<T>;
@@ -396,13 +469,41 @@ declare class BridgeClient {
     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(params: {
-        evmTxHash: string;
-        evmAddress: string;
-        evmSignature: string;
-        recipientPubkey: string;
+    /** 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(walletId: string, displayName?: string, encryptionPublicKey?: string): Promise<ApiResponse>;
+    getConversations(walletId: 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;
     }): Promise<ApiResponse>;
+    markRead(messageId: string): Promise<ApiResponse>;
 }
 
 declare class Wallet implements WalletKeys {
@@ -433,9 +534,10 @@ 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 createSignedBridgeWithdraw(wallet: WalletKeys, amount: number, evmAddress: string, tokenSymbol?: string, fee?: number): SignedTransaction;
 
 declare function hexToBytes(hex: string): Uint8Array;
 declare function bytesToHex(bytes: Uint8Array): string;
 declare function generateNonce(): string;
 
-export { type AddLiquidityParams, type ApiResponse, BURN_ADDRESS, type BalanceResponse, type BatchMintNftParams, type Block, type BlockHeader, type BridgeConfig, type BridgeWithdrawParams, type BridgeWithdrawal, type BurnNftParams, type CreateNftCollectionParams, type CreatePoolParams, type CreateTokenParams, type FreezeCollectionParams, type LiquidityPool, type LockNftParams, type MintNftParams, type NftCollection, type NftToken, type NodeStats, type PoolEvent, type PoolStats, type RemoveLiquidityParams, RougeChain, type RougeChainOptions, 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 Validator, Wallet, type WalletKeys, bytesToHex, generateNonce, hexToBytes, isBurnAddress, serializePayload, signTransaction, verifyTransaction };
+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 RemoveLiquidityParams, RougeChain, type RougeChainOptions, type SendMailParams, 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 Validator, Wallet, type WalletKeys, type XrgeBridgeClaimParams, type XrgeBridgeConfig, type XrgeBridgeWithdrawParams, bytesToHex, createSignedBridgeWithdraw, generateNonce, hexToBytes, isBurnAddress, serializePayload, signTransaction, verifyTransaction };

package/dist/index.d.ts

@@ -7,7 +7,7 @@ interface ApiResponse<T = unknown> {
     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";
+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";
 interface TransactionPayload {
     type: TransactionType;
     from: string;
@@ -15,6 +15,8 @@ interface TransactionPayload {
     amount?: number;
     fee?: number;
     token?: string;
+    tokenSymbol?: string;
+    evmAddress?: string;
     timestamp: number;
     nonce: string;
     token_name?: string;
@@ -189,6 +191,7 @@ interface BridgeConfig {
     enabled: boolean;
     custodyAddress?: string;
     chainId: number;
+    supportedTokens?: string[];
 }
 interface BridgeWithdrawal {
     tx_id: string;
@@ -198,6 +201,56 @@ interface BridgeWithdrawal {
     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 {
+    wallet_id: string;
+    display_name?: string;
+    encryption_public_key?: string;
+    created_at: number;
+}
+interface MessengerConversation {
+    id: string;
+    participants: string[];
+    created_at: number;
+}
+interface MessengerMessage {
+    id: string;
+    conversation_id: string;
+    sender: string;
+    encrypted_content: string;
+    media_type?: string;
+    media_data?: string;
+    self_destruct?: boolean;
+    read?: boolean;
+    created_at: number;
+}
 interface TransferParams {
     to: string;
     amount: number;
@@ -278,6 +331,24 @@ 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;
@@ -301,12 +372,14 @@ interface RougeChainOptions {
     apiKey?: string;
 }
 declare class RougeChain {
-    private readonly baseUrl;
-    private readonly fetchFn;
-    private readonly headers;
+    /** @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;
     constructor(baseUrl: string, options?: RougeChainOptions);
     /** @internal */
     get<T = unknown>(path: string): Promise<T>;
@@ -396,13 +469,41 @@ declare class BridgeClient {
     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(params: {
-        evmTxHash: string;
-        evmAddress: string;
-        evmSignature: string;
-        recipientPubkey: string;
+    /** 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(walletId: string, displayName?: string, encryptionPublicKey?: string): Promise<ApiResponse>;
+    getConversations(walletId: 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;
     }): Promise<ApiResponse>;
+    markRead(messageId: string): Promise<ApiResponse>;
 }
 
 declare class Wallet implements WalletKeys {
@@ -433,9 +534,10 @@ 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 createSignedBridgeWithdraw(wallet: WalletKeys, amount: number, evmAddress: string, tokenSymbol?: string, fee?: number): SignedTransaction;
 
 declare function hexToBytes(hex: string): Uint8Array;
 declare function bytesToHex(bytes: Uint8Array): string;
 declare function generateNonce(): string;
 
-export { type AddLiquidityParams, type ApiResponse, BURN_ADDRESS, type BalanceResponse, type BatchMintNftParams, type Block, type BlockHeader, type BridgeConfig, type BridgeWithdrawParams, type BridgeWithdrawal, type BurnNftParams, type CreateNftCollectionParams, type CreatePoolParams, type CreateTokenParams, type FreezeCollectionParams, type LiquidityPool, type LockNftParams, type MintNftParams, type NftCollection, type NftToken, type NodeStats, type PoolEvent, type PoolStats, type RemoveLiquidityParams, RougeChain, type RougeChainOptions, 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 Validator, Wallet, type WalletKeys, bytesToHex, generateNonce, hexToBytes, isBurnAddress, serializePayload, signTransaction, verifyTransaction };
+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 RemoveLiquidityParams, RougeChain, type RougeChainOptions, type SendMailParams, 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 Validator, Wallet, type WalletKeys, type XrgeBridgeClaimParams, type XrgeBridgeConfig, type XrgeBridgeWithdrawParams, bytesToHex, createSignedBridgeWithdraw, generateNonce, hexToBytes, isBurnAddress, serializePayload, signTransaction, verifyTransaction };