@veilux/sdk 0.3.0 → 0.3.2

package/dist/builders.d.ts

@@ -5,3 +5,6 @@ export declare function nftCreateCollection(submitter: PartyId, visibility: Visi
 export declare function storagePut(submitter: PartyId, visibility: Visibility, nonce: number, key: string, data: Uint8Array | number[]): Command;
 export declare function contractDeploy(submitter: PartyId, visibility: Visibility, nonce: number, code: Uint8Array | number[]): Command;
 export declare function contractCall(submitter: PartyId, visibility: Visibility, nonce: number, addressHex: string, args: number[], value: number, gasLimit: number): Command;
+export type ForeignChain = "cosmos" | "solana" | "ethereum" | "custom";
+export declare function bridgeRegisterChain(submitter: PartyId, visibility: Visibility, nonce: number, chain: ForeignChain, guardians: string[], quorum: number): Command;
+export declare function bridgeSend(submitter: PartyId, visibility: Visibility, nonce: number, chain: ForeignChain, recipient: string, tokenIdHex: string, amount: bigint | number | string): Command;

package/dist/builders.js

@@ -71,3 +71,20 @@ export function contractCall(submitter, visibility, nonce, addressHex, args, val
         gas_limit: gasLimit,
     });
 }
+export function bridgeRegisterChain(submitter, visibility, nonce, chain, guardians, quorum) {
+    return cmd("bridge", submitter, visibility, nonce, {
+        op: "register_chain",
+        chain,
+        guardians,
+        quorum,
+    });
+}
+export function bridgeSend(submitter, visibility, nonce, chain, recipient, tokenIdHex, amount) {
+    return cmd("bridge", submitter, visibility, nonce, {
+        op: "send",
+        chain,
+        recipient,
+        token_id: hashBytes(tokenIdHex),
+        amount: String(amount),
+    });
+}

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { type BlockView, type EstimateResult, type NodeInfo, type SignedCommand, type StateResult, type SubmitResult } from "./types.js";
+import { type BlockView, type ChainStats, type CommandLocation, type ContractCode, type EstimateResult, type EventView, type NodeInfo, type SignedCommand, type StatePrefixResult, type StateResult, type SubmitResult, type VerifyRequest, type VerifyResult } from "./types.js";
 export declare class RpcClientError extends Error {
     code: number;
     constructor(code: number, message: string);
@@ -28,4 +28,25 @@ export declare class Client {
         timeoutMs?: number;
         intervalMs?: number;
     }): Promise<number>;
+    /** Chain-wide statistics for dashboards. */
+    explorerStats(): Promise<ChainStats>;
+    /** The most recent blocks, newest first. */
+    recentBlocks(limit?: number): Promise<BlockView[]>;
+    /** Look up a block by its hash. */
+    blockByHash(hash: string): Promise<BlockView>;
+    /** Locate a command by id and return its block + produced events. */
+    searchCommand(commandId: string): Promise<CommandLocation>;
+    /** Recent events emitted by a given Prism (e.g. "token", "bridge"). */
+    listByPrism(prism: string, limit?: number): Promise<EventView[]>;
+    /** List state entries under a key prefix (e.g. "token/meta/"). */
+    statePrefix(prefix: string, limit?: number): Promise<StatePrefixResult>;
+    /** Fetch a contract's deployed bytecode + verification status. */
+    contractGetCode(address: string): Promise<ContractCode>;
+    /** Verify a contract's source against its on-chain bytecode. */
+    contractVerify(request: VerifyRequest): Promise<VerifyResult>;
+    /** Get a stored verification record, if any. */
+    contractGetVerification(address: string): Promise<{
+        found: boolean;
+        record?: unknown;
+    }>;
 }

package/dist/client.js

@@ -85,4 +85,42 @@ export class Client {
             await new Promise((r) => setTimeout(r, intervalMs));
         }
     }
+    // ---- Explorer queries ----
+    /** Chain-wide statistics for dashboards. */
+    explorerStats() {
+        return this.call(RPC_METHODS.explorerStats, {});
+    }
+    /** The most recent blocks, newest first. */
+    recentBlocks(limit = 20) {
+        return this.call(RPC_METHODS.explorerRecentBlocks, { limit });
+    }
+    /** Look up a block by its hash. */
+    blockByHash(hash) {
+        return this.call(RPC_METHODS.explorerBlockByHash, { hash });
+    }
+    /** Locate a command by id and return its block + produced events. */
+    searchCommand(commandId) {
+        return this.call(RPC_METHODS.explorerSearchCommand, { command_id: commandId });
+    }
+    /** Recent events emitted by a given Prism (e.g. "token", "bridge"). */
+    listByPrism(prism, limit = 50) {
+        return this.call(RPC_METHODS.explorerListByPrism, { prism, limit });
+    }
+    /** List state entries under a key prefix (e.g. "token/meta/"). */
+    statePrefix(prefix, limit = 100) {
+        return this.call(RPC_METHODS.explorerStatePrefix, { prefix, limit });
+    }
+    // ---- Contract verification ----
+    /** Fetch a contract's deployed bytecode + verification status. */
+    contractGetCode(address) {
+        return this.call(RPC_METHODS.contractGetCode, { address });
+    }
+    /** Verify a contract's source against its on-chain bytecode. */
+    contractVerify(request) {
+        return this.call(RPC_METHODS.contractVerify, request);
+    }
+    /** Get a stored verification record, if any. */
+    contractGetVerification(address) {
+        return this.call(RPC_METHODS.contractGetVerification, { address });
+    }
 }

package/dist/types.d.ts

@@ -73,4 +73,74 @@ export declare const RPC_METHODS: {
     readonly getBlockByNumber: "veilux_getBlockByNumber";
     readonly getState: "veilux_getState";
     readonly estimate: "veilux_estimate";
+    readonly explorerStats: "explorer_stats";
+    readonly explorerRecentBlocks: "explorer_recentBlocks";
+    readonly explorerBlockByHash: "explorer_blockByHash";
+    readonly explorerSearchCommand: "explorer_searchCommand";
+    readonly explorerListByPrism: "explorer_listByPrism";
+    readonly explorerStatePrefix: "explorer_statePrefix";
+    readonly contractGetCode: "contract_getCode";
+    readonly contractVerify: "contract_verify";
+    readonly contractGetVerification: "contract_getVerification";
 };
+export interface ChainStats {
+    height: number;
+    total_blocks: number;
+    total_commands: number;
+    total_events: number;
+    head_hash: string;
+    state_root: string;
+    state_entries: number;
+    events_by_prism: Record<string, number>;
+}
+export interface EventView {
+    block_height: number;
+    prism: string;
+    commitment: string;
+    source_command: string;
+    visibility: string;
+    redacted: boolean;
+    stakeholders: number;
+    payload_json: unknown | null;
+    payload_hex: string | null;
+}
+export interface CommandLocation {
+    found: boolean;
+    command_id: string;
+    block_height: number | null;
+    block_hash: string | null;
+    prism: string | null;
+    submitter: string | null;
+    events: EventView[];
+}
+export interface StateEntry {
+    key: string;
+    value_hex: string;
+}
+export interface StatePrefixResult {
+    prefix: string;
+    total: number;
+    entries: StateEntry[];
+}
+export interface ContractCode {
+    address: string;
+    found: boolean;
+    deployer: string | null;
+    bytecode_hex: string;
+    code_size: number;
+    code_hash: string;
+    verified: boolean;
+}
+export interface VerifyRequest {
+    address: string;
+    name: string;
+    source: string;
+    bytecode_hex: string;
+    compiler: string;
+    abi?: string;
+}
+export interface VerifyResult {
+    verified: boolean;
+    message: string;
+    code_hash: string;
+}

package/dist/types.js

@@ -6,4 +6,13 @@ export const RPC_METHODS = {
     getBlockByNumber: "veilux_getBlockByNumber",
     getState: "veilux_getState",
     estimate: "veilux_estimate",
+    explorerStats: "explorer_stats",
+    explorerRecentBlocks: "explorer_recentBlocks",
+    explorerBlockByHash: "explorer_blockByHash",
+    explorerSearchCommand: "explorer_searchCommand",
+    explorerListByPrism: "explorer_listByPrism",
+    explorerStatePrefix: "explorer_statePrefix",
+    contractGetCode: "contract_getCode",
+    contractVerify: "contract_verify",
+    contractGetVerification: "contract_getVerification",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veilux/sdk",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "VEILUX TypeScript SDK — build, sign, and submit commands to a VEILUX node",
   "license": "MIT",
   "author": "nathan <nathan@winnode.xyz>",
@@ -23,10 +23,10 @@
   },
   "scripts": {
     "build": "tsc",
+    "build:examples": "tsc -p examples/tsconfig.json",
     "pretest": "tsc && tsc test/compat.test.ts --rootDir test --outDir test-dist --module ESNext --target ES2020 --moduleResolution Bundler --skipLibCheck --types node",
     "test": "node --test test-dist/",
-    "example": "node --loader ts-node/esm examples/quickstart.ts",
-    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true});require('fs').rmSync('test-dist',{recursive:true,force:true})\""
+    "clean": "node -e \"['dist','test-dist','examples-dist'].forEach(d=>require('fs').rmSync(d,{recursive:true,force:true}))\""
   },
   "dependencies": {
     "@noble/ed25519": "^2.1.0",