tenzro-sdk 0.1.0

package/dist/debridge.d.ts

@@ -0,0 +1,129 @@
+import type { RpcClient } from './rpc';
+/** A chain supported by deBridge DLN. */
+export interface DebridgeChain {
+    /** Numeric chain ID */
+    chainId: number;
+    /** Human-readable chain name (e.g. "Ethereum", "Solana") */
+    name: string;
+    /** Chain type (e.g. "evm", "svm") */
+    chain_type?: string;
+}
+/** A token available on deBridge DLN. */
+export interface DebridgeToken {
+    /** Token contract address (or native token sentinel) */
+    address: string;
+    /** Token ticker symbol (e.g. "USDC") */
+    symbol: string;
+    /** Full token name */
+    name: string;
+    /** Number of decimals */
+    decimals: number;
+    /** Chain ID the token is on */
+    chainId?: number;
+}
+/** A cross-chain order created via deBridge DLN. */
+export interface DebridgeOrder {
+    /** Order identifier */
+    order_id: string;
+    /** Source chain ID */
+    src_chain: number;
+    /** Destination chain ID */
+    dst_chain: number;
+    /** Source token address */
+    src_token: string;
+    /** Destination token address */
+    dst_token: string;
+    /** Amount as a decimal string */
+    amount: string;
+    /** Recipient address on the destination chain */
+    recipient: string;
+    /** Order status */
+    status: string;
+    /** Transaction data to sign and submit */
+    tx_data?: Record<string, unknown>;
+}
+/** Result of a same-chain swap via deBridge. */
+export interface DebridgeSwapResult {
+    /** Transaction hash */
+    tx_hash?: string;
+    /** Input token address */
+    token_in: string;
+    /** Output token address */
+    token_out: string;
+    /** Input amount as a decimal string */
+    amount_in: string;
+    /** Output amount as a decimal string */
+    amount_out: string;
+    /** Status */
+    status: string;
+    /** Transaction data to sign and submit */
+    tx_data?: Record<string, unknown>;
+}
+/** deBridge usage instructions and supported features. */
+export interface DebridgeInstructions {
+    /** Supported order types */
+    order_types: string[];
+    /** Supported features */
+    features: string[];
+    /** API version */
+    api_version: string;
+}
+/**
+ * Client for deBridge DLN (Decentalized Liquidity Network) cross-chain operations.
+ * Supports token search, chain listing, cross-chain order creation,
+ * and same-chain swaps. Order status is tracked via `stats-api.dln.trade`.
+ *
+ * deBridge uses an intent-based model: callers create orders specifying
+ * source/destination chains and tokens, and market makers (takers) fill them.
+ */
+export declare class DebridgeClient {
+    private readonly rpc;
+    constructor(rpc: RpcClient);
+    /**
+     * Search for tokens available on deBridge DLN.
+     * @param query - Search query (token name or symbol)
+     * @param chainId - Optional chain ID filter
+     * @returns Array of matching tokens
+     */
+    searchTokens(query: string, chainId?: number): Promise<DebridgeToken[]>;
+    /**
+     * List all chains supported by deBridge DLN.
+     * @returns Array of supported chains
+     */
+    getChains(): Promise<DebridgeChain[]>;
+    /**
+     * Get deBridge usage instructions and supported features.
+     * @returns Instructions including order types and API version
+     */
+    getInstructions(): Promise<DebridgeInstructions>;
+    /**
+     * Create a cross-chain order via deBridge DLN.
+     * Returns unsigned transaction data that the caller must sign and submit.
+     * @param srcChain - Source chain ID
+     * @param dstChain - Destination chain ID
+     * @param srcToken - Source token address
+     * @param dstToken - Destination token address
+     * @param amount - Amount as a decimal string (in source token units)
+     * @param recipient - Recipient address on the destination chain
+     * @returns Order details with transaction data to sign
+     */
+    createTx(srcChain: number, dstChain: number, srcToken: string, dstToken: string, amount: string, recipient: string): Promise<DebridgeOrder>;
+    /**
+     * Execute a same-chain swap via deBridge.
+     * Returns unsigned transaction data for a single-chain token swap.
+     * @param chainId - Chain ID to swap on
+     * @param tokenIn - Input token address
+     * @param tokenOut - Output token address
+     * @param amount - Input amount as a decimal string
+     * @returns Swap result with transaction data
+     */
+    sameChainSwap(chainId: number, tokenIn: string, tokenOut: string, amount: string): Promise<DebridgeSwapResult>;
+    /**
+     * Get the status of an existing deBridge DLN order.
+     * Status is fetched from the deBridge stats API (`stats-api.dln.trade`).
+     * @param orderId - Order identifier
+     * @returns Order details including current status
+     */
+    getOrderStatus(orderId: string): Promise<DebridgeOrder>;
+}
+//# sourceMappingURL=debridge.d.ts.map

package/dist/debridge.d.ts.map

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

package/dist/debridge.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebridgeClient = void 0;
+// ── Client ──
+/**
+ * Client for deBridge DLN (Decentalized Liquidity Network) cross-chain operations.
+ * Supports token search, chain listing, cross-chain order creation,
+ * and same-chain swaps. Order status is tracked via `stats-api.dln.trade`.
+ *
+ * deBridge uses an intent-based model: callers create orders specifying
+ * source/destination chains and tokens, and market makers (takers) fill them.
+ */
+class DebridgeClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * Search for tokens available on deBridge DLN.
+     * @param query - Search query (token name or symbol)
+     * @param chainId - Optional chain ID filter
+     * @returns Array of matching tokens
+     */
+    async searchTokens(query, chainId) {
+        return this.rpc.call('tenzro_debridgeSearchTokens', [
+            { query, chain_id: chainId },
+        ]);
+    }
+    /**
+     * List all chains supported by deBridge DLN.
+     * @returns Array of supported chains
+     */
+    async getChains() {
+        return this.rpc.call('tenzro_debridgeGetChains');
+    }
+    /**
+     * Get deBridge usage instructions and supported features.
+     * @returns Instructions including order types and API version
+     */
+    async getInstructions() {
+        return this.rpc.call('tenzro_debridgeGetInstructions');
+    }
+    /**
+     * Create a cross-chain order via deBridge DLN.
+     * Returns unsigned transaction data that the caller must sign and submit.
+     * @param srcChain - Source chain ID
+     * @param dstChain - Destination chain ID
+     * @param srcToken - Source token address
+     * @param dstToken - Destination token address
+     * @param amount - Amount as a decimal string (in source token units)
+     * @param recipient - Recipient address on the destination chain
+     * @returns Order details with transaction data to sign
+     */
+    async createTx(srcChain, dstChain, srcToken, dstToken, amount, recipient) {
+        return this.rpc.call('tenzro_debridgeCreateTx', [
+            {
+                src_chain: srcChain,
+                dst_chain: dstChain,
+                src_token: srcToken,
+                dst_token: dstToken,
+                amount,
+                recipient,
+            },
+        ]);
+    }
+    /**
+     * Execute a same-chain swap via deBridge.
+     * Returns unsigned transaction data for a single-chain token swap.
+     * @param chainId - Chain ID to swap on
+     * @param tokenIn - Input token address
+     * @param tokenOut - Output token address
+     * @param amount - Input amount as a decimal string
+     * @returns Swap result with transaction data
+     */
+    async sameChainSwap(chainId, tokenIn, tokenOut, amount) {
+        return this.rpc.call('tenzro_debridgeSameChainSwap', [
+            { chain_id: chainId, token_in: tokenIn, token_out: tokenOut, amount },
+        ]);
+    }
+    /**
+     * Get the status of an existing deBridge DLN order.
+     * Status is fetched from the deBridge stats API (`stats-api.dln.trade`).
+     * @param orderId - Order identifier
+     * @returns Order details including current status
+     */
+    async getOrderStatus(orderId) {
+        return this.rpc.call('tenzro_debridgeGetOrderStatus', [
+            { order_id: orderId },
+        ]);
+    }
+}
+exports.DebridgeClient = DebridgeClient;
+//# sourceMappingURL=debridge.js.map

package/dist/debridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debridge.js","sourceRoot":"","sources":["../src/debridge.ts"],"names":[],"mappings":";;;AA8EA,eAAe;AAEf;;;;;;;GAOG;AACH,MAAa,cAAc;IACI;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAChB,KAAa,EACb,OAAgB;QAEhB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAkB,6BAA6B,EAAE;YACnE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAkB,0BAA0B,CAAC,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAClB,gCAAgC,CACjC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,CACZ,QAAgB,EAChB,QAAgB,EAChB,QAAgB,EAChB,QAAgB,EAChB,MAAc,EACd,SAAiB;QAEjB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAgB,yBAAyB,EAAE;YAC7D;gBACE,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,QAAQ;gBACnB,MAAM;gBACN,SAAS;aACV;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CACjB,OAAe,EACf,OAAe,EACf,QAAgB,EAChB,MAAc;QAEd,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAqB,8BAA8B,EAAE;YACvE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE;SACtE,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAgB,+BAA+B,EAAE;YACnE,EAAE,QAAQ,EAAE,OAAO,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;CACF;AAlGD,wCAkGC"}

package/dist/erc7802.d.ts

@@ -0,0 +1,36 @@
+import type { RpcClient } from './rpc';
+import type { MintResult, BurnResult, CrossChainSupply } from './types';
+/**
+ * Client for ERC-7802 cross-chain token interface operations.
+ * Supports cross-chain minting, burning, and supply queries
+ * for tokens that implement the ERC-7802 standard.
+ */
+export declare class Erc7802Client {
+    private readonly rpc;
+    constructor(rpc: RpcClient);
+    /**
+     * Mint tokens on the current chain authorized by a source chain burn.
+     * @param token - Token address or symbol
+     * @param recipient - Recipient address for the minted tokens
+     * @param amount - Amount to mint (decimal string)
+     * @param sourceChain - Source chain that authorized this mint
+     * @returns Mint result with transaction hash
+     */
+    crosschainMint(token: string, recipient: string, amount: string, sourceChain: string): Promise<MintResult>;
+    /**
+     * Burn tokens on the current chain to authorize minting on a target chain.
+     * @param token - Token address or symbol
+     * @param from - Address to burn tokens from
+     * @param amount - Amount to burn (decimal string)
+     * @param targetChain - Target chain where tokens will be minted
+     * @returns Burn result with transaction hash
+     */
+    crosschainBurn(token: string, from: string, amount: string, targetChain: string): Promise<BurnResult>;
+    /**
+     * Get the cross-chain supply breakdown for a token.
+     * @param token - Token address or symbol
+     * @returns Cross-chain supply with per-chain breakdown
+     */
+    getCrossChainSupply(token: string): Promise<CrossChainSupply>;
+}
+//# sourceMappingURL=erc7802.d.ts.map

package/dist/erc7802.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc7802.d.ts","sourceRoot":"","sources":["../src/erc7802.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAExE;;;;GAIG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C;;;;;;;OAOG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC;IAMtB;;;;;;;OAOG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC;IAMtB;;;;OAIG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAKpE"}

package/dist/erc7802.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Erc7802Client = void 0;
+/**
+ * Client for ERC-7802 cross-chain token interface operations.
+ * Supports cross-chain minting, burning, and supply queries
+ * for tokens that implement the ERC-7802 standard.
+ */
+class Erc7802Client {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * Mint tokens on the current chain authorized by a source chain burn.
+     * @param token - Token address or symbol
+     * @param recipient - Recipient address for the minted tokens
+     * @param amount - Amount to mint (decimal string)
+     * @param sourceChain - Source chain that authorized this mint
+     * @returns Mint result with transaction hash
+     */
+    async crosschainMint(token, recipient, amount, sourceChain) {
+        return this.rpc.call('tenzro_erc7802CrosschainMint', [
+            { token, recipient, amount, source_chain: sourceChain },
+        ]);
+    }
+    /**
+     * Burn tokens on the current chain to authorize minting on a target chain.
+     * @param token - Token address or symbol
+     * @param from - Address to burn tokens from
+     * @param amount - Amount to burn (decimal string)
+     * @param targetChain - Target chain where tokens will be minted
+     * @returns Burn result with transaction hash
+     */
+    async crosschainBurn(token, from, amount, targetChain) {
+        return this.rpc.call('tenzro_erc7802CrosschainBurn', [
+            { token, from, amount, target_chain: targetChain },
+        ]);
+    }
+    /**
+     * Get the cross-chain supply breakdown for a token.
+     * @param token - Token address or symbol
+     * @returns Cross-chain supply with per-chain breakdown
+     */
+    async getCrossChainSupply(token) {
+        return this.rpc.call('tenzro_erc7802GetCrossChainSupply', [
+            { token },
+        ]);
+    }
+}
+exports.Erc7802Client = Erc7802Client;
+//# sourceMappingURL=erc7802.js.map

package/dist/erc7802.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc7802.js","sourceRoot":"","sources":["../src/erc7802.ts"],"names":[],"mappings":";;;AAGA;;;;GAIG;AACH,MAAa,aAAa;IACK;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAClB,KAAa,EACb,SAAiB,EACjB,MAAc,EACd,WAAmB;QAEnB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,8BAA8B,EAAE;YAC/D,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAClB,KAAa,EACb,IAAY,EACZ,MAAc,EACd,WAAmB;QAEnB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,8BAA8B,EAAE;YAC/D,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE;SACnD,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAa;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAmB,mCAAmC,EAAE;YAC1E,EAAE,KAAK,EAAE;SACV,CAAC,CAAC;IACL,CAAC;CACF;AAnDD,sCAmDC"}

package/dist/events.d.ts

@@ -0,0 +1,112 @@
+import type { RpcClient } from './rpc';
+/** A blockchain event emitted by the Tenzro Ledger. */
+export interface BlockchainEvent {
+    /** Event type (e.g. "Transfer", "Mint", "Stake", "Slash", "ProposalCreated") */
+    event_type: string;
+    /** Block number where the event was emitted */
+    block_number: number;
+    /** Transaction hash that produced the event */
+    tx_hash?: string;
+    /** Event-specific data payload */
+    data: Record<string, unknown>;
+    /** ISO-8601 timestamp */
+    timestamp?: string;
+}
+/** Parameters for querying events. */
+export interface GetEventsParams {
+    /** Start block number (inclusive) */
+    from_block?: number;
+    /** End block number (inclusive) */
+    to_block?: number;
+    /** Filter by event type */
+    event_type?: string;
+    /** Filter by emitting contract address */
+    address?: string;
+    /** Maximum number of events to return */
+    limit?: number;
+}
+/** An active event subscription. */
+export interface Subscription {
+    /** Unique subscription identifier */
+    subscription_id: string;
+    /** WebSocket URL for receiving events (if available) */
+    ws_url?: string;
+    /** gRPC URL for receiving events (if available) */
+    grpc_url?: string;
+    /** Event types included in this subscription */
+    event_types: string[];
+    /** Subscription status */
+    status: string;
+}
+/** A registered webhook for event notifications. */
+export interface WebhookRegistration {
+    /** Unique webhook identifier */
+    webhook_id: string;
+    /** Callback URL where events will be POSTed */
+    url: string;
+    /** Event types the webhook is subscribed to */
+    event_types?: string[];
+    /** Whether HMAC verification is enabled */
+    hmac_enabled: boolean;
+    /** Webhook status */
+    status: string;
+}
+/** Result of unsubscribing from events. */
+export interface UnsubscribeResult {
+    /** Subscription identifier that was removed */
+    subscription_id: string;
+    /** Whether the unsubscription succeeded */
+    success: boolean;
+}
+/** Result of removing a webhook registration. */
+export interface WebhookRemoveResult {
+    /** Webhook identifier that was removed */
+    webhook_id: string;
+    /** Whether the removal succeeded */
+    success: boolean;
+}
+/**
+ * Client for blockchain event queries, subscriptions, and webhooks.
+ * Supports querying historical events, subscribing to real-time events
+ * via WebSocket/gRPC, and registering webhooks for push notifications.
+ */
+export declare class EventsClient {
+    private readonly rpc;
+    constructor(rpc: RpcClient);
+    /**
+     * Query historical blockchain events with optional filters.
+     * @param params - Optional filter parameters (block range, event type, address)
+     * @returns Array of matching events
+     */
+    getEvents(params?: GetEventsParams): Promise<BlockchainEvent[]>;
+    /**
+     * Subscribe to real-time blockchain events.
+     * Returns connection details for receiving events via WebSocket or gRPC.
+     * @param eventTypes - Array of event types to subscribe to (e.g. ["Transfer", "Stake"])
+     * @returns Subscription details with connection URLs
+     */
+    subscribeEvents(eventTypes: string[]): Promise<Subscription>;
+    /**
+     * Unsubscribe from a previously created event subscription.
+     * @param subscriptionId - Subscription identifier to remove
+     * @returns Unsubscription result
+     */
+    unsubscribeEvents(subscriptionId: string): Promise<UnsubscribeResult>;
+    /**
+     * Register a webhook to receive event notifications via HTTP POST.
+     * Events matching the specified types will be POSTed to the callback URL.
+     * An optional HMAC secret enables signature verification on the receiver side.
+     * @param url - Callback URL (must be HTTPS in production)
+     * @param eventTypes - Optional event type filter; omit to receive all events
+     * @param secret - Optional HMAC-SHA256 secret for webhook signature verification
+     * @returns Webhook registration details
+     */
+    registerWebhook(url: string, eventTypes?: string[], secret?: string): Promise<WebhookRegistration>;
+    /**
+     * Remove a previously registered webhook.
+     * @param webhookId - Webhook identifier to remove
+     * @returns Removal result
+     */
+    removeWebhook(webhookId: string): Promise<WebhookRemoveResult>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,2CAA2C;IAC3C,YAAY,EAAE,OAAO,CAAC;IACtB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAID;;;;GAIG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C;;;;OAIG;IACG,SAAS,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIrE;;;;;OAKG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAMlE;;;;OAIG;IACG,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAM3E;;;;;;;;OAQG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC;IAM/B;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAKrE"}

package/dist/events.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsClient = void 0;
+// ── Client ──
+/**
+ * Client for blockchain event queries, subscriptions, and webhooks.
+ * Supports querying historical events, subscribing to real-time events
+ * via WebSocket/gRPC, and registering webhooks for push notifications.
+ */
+class EventsClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * Query historical blockchain events with optional filters.
+     * @param params - Optional filter parameters (block range, event type, address)
+     * @returns Array of matching events
+     */
+    async getEvents(params) {
+        return this.rpc.call('tenzro_getEvents', [params ?? {}]);
+    }
+    /**
+     * Subscribe to real-time blockchain events.
+     * Returns connection details for receiving events via WebSocket or gRPC.
+     * @param eventTypes - Array of event types to subscribe to (e.g. ["Transfer", "Stake"])
+     * @returns Subscription details with connection URLs
+     */
+    async subscribeEvents(eventTypes) {
+        return this.rpc.call('tenzro_subscribeEvents', [
+            { event_types: eventTypes },
+        ]);
+    }
+    /**
+     * Unsubscribe from a previously created event subscription.
+     * @param subscriptionId - Subscription identifier to remove
+     * @returns Unsubscription result
+     */
+    async unsubscribeEvents(subscriptionId) {
+        return this.rpc.call('tenzro_unsubscribeEvents', [
+            { subscription_id: subscriptionId },
+        ]);
+    }
+    /**
+     * Register a webhook to receive event notifications via HTTP POST.
+     * Events matching the specified types will be POSTed to the callback URL.
+     * An optional HMAC secret enables signature verification on the receiver side.
+     * @param url - Callback URL (must be HTTPS in production)
+     * @param eventTypes - Optional event type filter; omit to receive all events
+     * @param secret - Optional HMAC-SHA256 secret for webhook signature verification
+     * @returns Webhook registration details
+     */
+    async registerWebhook(url, eventTypes, secret) {
+        return this.rpc.call('tenzro_registerWebhook', [
+            { url, event_types: eventTypes, secret },
+        ]);
+    }
+    /**
+     * Remove a previously registered webhook.
+     * @param webhookId - Webhook identifier to remove
+     * @returns Removal result
+     */
+    async removeWebhook(webhookId) {
+        return this.rpc.call('tenzro_removeWebhook', [
+            { webhook_id: webhookId },
+        ]);
+    }
+}
+exports.EventsClient = EventsClient;
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";;;AA4EA,eAAe;AAEf;;;;GAIG;AACH,MAAa,YAAY;IACM;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,MAAwB;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAoB,kBAAkB,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,UAAoB;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAe,wBAAwB,EAAE;YAC3D,EAAE,WAAW,EAAE,UAAU,EAAE;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CAAC,cAAsB;QAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAoB,0BAA0B,EAAE;YAClE,EAAE,eAAe,EAAE,cAAc,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,eAAe,CACnB,GAAW,EACX,UAAqB,EACrB,MAAe;QAEf,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAsB,wBAAwB,EAAE;YAClE,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE;SACzC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAsB,sBAAsB,EAAE;YAChE,EAAE,UAAU,EAAE,SAAS,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;CACF;AAhED,oCAgEC"}

package/dist/governance.d.ts

@@ -0,0 +1,55 @@
+import { RpcClient } from "./rpc";
+import { GovernanceProposal, VoteType, VoteReceipt, VotingPower } from "./types";
+/**
+ * Client for on-chain governance operations.
+ * Supports proposal creation, voting, and delegation.
+ */
+export declare class GovernanceClient {
+    private rpc;
+    constructor(rpc: RpcClient);
+    /**
+     * List governance proposals.
+     * @param status - Optional filter by proposal status
+     * @returns Array of governance proposals
+     */
+    listProposals(status?: string): Promise<GovernanceProposal[]>;
+    /**
+     * Get details of a specific proposal.
+     * @param proposalId - The proposal identifier
+     * @returns Proposal details
+     */
+    getProposal(proposalId: string): Promise<GovernanceProposal>;
+    /**
+     * Create a new governance proposal.
+     * @param params - Proposal parameters
+     * @returns Created proposal
+     */
+    createProposal(params: {
+        title: string;
+        description: string;
+        proposalType: string;
+        executionData?: string;
+    }): Promise<GovernanceProposal>;
+    /**
+     * Vote on a governance proposal.
+     * @param proposalId - The proposal to vote on
+     * @param voteType - "For", "Against", or "Abstain"
+     * @param justification - Optional justification for the vote
+     * @returns Vote receipt
+     */
+    vote(proposalId: string, voteType: VoteType, justification?: string): Promise<VoteReceipt>;
+    /**
+     * Get voting power for an address.
+     * @param address - The address to query
+     * @returns Voting power information
+     */
+    getVotingPower(address: string): Promise<VotingPower>;
+    /**
+     * Delegate voting power to another address.
+     * @param delegate - Address to delegate to
+     * @param amount - Amount of voting power to delegate
+     * @returns Transaction hash
+     */
+    delegateVotingPower(delegate: string, amount: string): Promise<string>;
+}
+//# sourceMappingURL=governance.d.ts.map

package/dist/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../src/governance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAElC;;;;OAIG;IACG,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAMnE;;;;OAIG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAMlE;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI/B;;;;;;OAMG;IACG,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,WAAW,CAAC;IAQvB;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI3D;;;;;OAKG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAM7E"}

package/dist/governance.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GovernanceClient = void 0;
+/**
+ * Client for on-chain governance operations.
+ * Supports proposal creation, voting, and delegation.
+ */
+class GovernanceClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * List governance proposals.
+     * @param status - Optional filter by proposal status
+     * @returns Array of governance proposals
+     */
+    async listProposals(status) {
+        return this.rpc.call("tenzro_listProposals", [
+            status,
+        ]);
+    }
+    /**
+     * Get details of a specific proposal.
+     * @param proposalId - The proposal identifier
+     * @returns Proposal details
+     */
+    async getProposal(proposalId) {
+        return this.rpc.call("tenzro_getProposal", [
+            proposalId,
+        ]);
+    }
+    /**
+     * Create a new governance proposal.
+     * @param params - Proposal parameters
+     * @returns Created proposal
+     */
+    async createProposal(params) {
+        return this.rpc.call("tenzro_createProposal", [params]);
+    }
+    /**
+     * Vote on a governance proposal.
+     * @param proposalId - The proposal to vote on
+     * @param voteType - "For", "Against", or "Abstain"
+     * @param justification - Optional justification for the vote
+     * @returns Vote receipt
+     */
+    async vote(proposalId, voteType, justification) {
+        return this.rpc.call("tenzro_vote", [
+            proposalId,
+            voteType,
+            justification,
+        ]);
+    }
+    /**
+     * Get voting power for an address.
+     * @param address - The address to query
+     * @returns Voting power information
+     */
+    async getVotingPower(address) {
+        return this.rpc.call("tenzro_getVotingPower", [address]);
+    }
+    /**
+     * Delegate voting power to another address.
+     * @param delegate - Address to delegate to
+     * @param amount - Amount of voting power to delegate
+     * @returns Transaction hash
+     */
+    async delegateVotingPower(delegate, amount) {
+        return this.rpc.call("tenzro_delegateVotingPower", [
+            delegate,
+            amount,
+        ]);
+    }
+}
+exports.GovernanceClient = GovernanceClient;
+//# sourceMappingURL=governance.js.map

package/dist/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../src/governance.ts"],"names":[],"mappings":";;;AAQA;;;GAGG;AACH,MAAa,gBAAgB;IACP;IAApB,YAAoB,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAEtC;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,MAAe;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAuB,sBAAsB,EAAE;YACjE,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAqB,oBAAoB,EAAE;YAC7D,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,MAKpB;QACC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAqB,uBAAuB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,UAAkB,EAClB,QAAkB,EAClB,aAAsB;QAEtB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAc,aAAa,EAAE;YAC/C,UAAU;YACV,QAAQ;YACR,aAAa;SACd,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAc,uBAAuB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CAAC,QAAgB,EAAE,MAAc;QACxD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAS,4BAA4B,EAAE;YACzD,QAAQ;YACR,MAAM;SACP,CAAC,CAAC;IACL,CAAC;CACF;AA/ED,4CA+EC"}