@xian-tech/client 0.1.5 → 0.1.7

package/README.md

@@ -14,3 +14,15 @@ It does not own:
 - browser wallet discovery
 - wallet-provider event contracts
 - framework-specific bindings
+
+```mermaid
+flowchart LR
+  App["JS or TS app"] --> Client["XianClient"]
+  Client --> Queries["ABCI and HTTP queries"]
+  Client --> Tx["Build, sign, and broadcast tx"]
+  Client --> Watch["Websocket subscriptions"]
+  Signer["Ed25519Signer"] --> Tx
+  Queries --> Node["Xian node"]
+  Tx --> Node
+  Watch --> Dashboard["Dashboard websocket"]
+```

package/dist/client.d.ts

@@ -1,10 +1,18 @@
 import { WatchApi } from "./watch.js";
-import type { BroadcastMode, BroadcastTxOptions, BuildTxRequest, ContractSendOptions, EstimateStampsOptions, EstimateStampsResult, GetTokenBalancesOptions, SimulateRequest, TokenApproveOptions, TokenTransferOptions, TransactionReceipt, TransactionSubmission, WaitForTxOptions, XianClientOptions, XianTokenBalancesResult, XianSignedTransaction, XianSigner, XianUnsignedTransaction } from "./types.js";
+import type { BroadcastMode, BroadcastTxOptions, BuildTxRequest, ContractSendOptions, DeployContractOptions, SubmitContractOptions, EstimateChiResult, GetShieldedWalletHistoryOptions, GetTokenBalancesOptions, SimulateRequest, TokenApproveOptions, TokenTransferOptions, TransactionReceipt, TransactionSubmission, WaitForTxOptions, XianClientOptions, XianShieldedWalletHistoryResult, XianTokenBalancesResult, XianSignedTransaction, XianSigner, XianUnsignedTransaction } from "./types.js";
+/**
+ * Combine a caller-provided AbortSignal with a timeout-backed internal
+ * signal so either one triggering aborts the underlying fetch. We prefer
+ * AbortSignal.any when available; on older runtimes we stitch them
+ * together manually.
+ */
+export declare function mergeAbortSignals(a: AbortSignal | undefined, b: AbortSignal | undefined): AbortSignal | undefined;
 export declare class XianClient {
     readonly rpcUrl: string;
     readonly dashboardUrl?: string;
     readonly watch: WatchApi;
     private readonly fetchFn;
+    private readonly requestTimeoutMs;
     private chainIdCache?;
     constructor(options: XianClientOptions);
     private requestJson;
@@ -27,11 +35,13 @@ export declare class XianClient {
         name: string | null;
         symbol: string | null;
         logoUrl: string | null;
+        logoSvg: string | null;
     }>;
     getTokenBalances(address: string, options?: GetTokenBalancesOptions): Promise<XianTokenBalancesResult>;
-    getStampRate(): Promise<number | bigint | null>;
-    getContract(contract: string): Promise<string | null>;
-    getContractCode(contract: string): Promise<string | null>;
+    getShieldedWalletHistory(tagValue: string, options?: GetShieldedWalletHistoryOptions): Promise<XianShieldedWalletHistoryResult>;
+    getChiRate(): Promise<number | bigint | null>;
+    getContractSource(contract: string): Promise<string | null>;
+    getContractIr(contract: string): Promise<string | null>;
     getContractMethods(contract: string): Promise<{
         name: string;
         arguments: {
@@ -41,7 +51,7 @@ export declare class XianClient {
     }[]>;
     simulate(request: SimulateRequest): Promise<Record<string, unknown>>;
     call(request: SimulateRequest): Promise<unknown>;
-    estimateStamps(request: SimulateRequest, options?: EstimateStampsOptions): Promise<EstimateStampsResult>;
+    estimateChi(request: SimulateRequest): Promise<EstimateChiResult>;
     buildTx(request: BuildTxRequest): Promise<XianUnsignedTransaction>;
     signTx(tx: XianUnsignedTransaction, signer: XianSigner): Promise<XianSignedTransaction>;
     broadcastTx(tx: XianSignedTransaction, options?: BroadcastTxOptions): Promise<TransactionSubmission>;
@@ -53,6 +63,8 @@ export declare class XianClient {
         timeoutMs?: number;
         pollIntervalMs?: number;
     }): Promise<TransactionSubmission>;
+    submitContract(request: SubmitContractOptions): Promise<TransactionSubmission>;
+    deployContract(request: DeployContractOptions): Promise<TransactionSubmission>;
     contract(name: string): ContractClient;
     token(name?: string): TokenClient;
 }
@@ -75,6 +87,7 @@ export declare class TokenClient {
         name: string | null;
         symbol: string | null;
         logoUrl: string | null;
+        logoSvg: string | null;
     }>;
     allowance(owner: string, spender: string): Promise<unknown>;
     transfer(options: TokenTransferOptions): Promise<TransactionSubmission>;

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -1,12 +1,12 @@
-import { base64ToUtf8, bytesToHex, canonicalizeRuntime, decodeRuntime, encodeRuntime, parseXianNumber, sortKeysDeep, utf8ToBytes } from "./encoding.js";
+import { base64ToUtf8, bytesToHex, canonicalizeRuntime, decodeRuntime, encodeRuntime, normalizeMaybeInteger, normalizeMaybeXianNumber, parseXianNumber, sortKeysDeep, utf8ToBytes } from "./encoding.js";
+import { compileContractArtifacts } from "./compiler.js";
 import { isValidEd25519Signature } from "./ed25519.js";
 import { AbciError, RpcError, SimulationError, TransactionError, TransportError, TxTimeoutError } from "./errors.js";
 import { WatchApi } from "./watch.js";
 const EMPTY_ABCI_VALUE = "AA==";
 const DEFAULT_TIMEOUT_MS = 30_000;
 const DEFAULT_POLL_INTERVAL_MS = 500;
-const DEFAULT_STAMP_MARGIN = 0.2;
-const DEFAULT_MIN_STAMP_HEADROOM = 5_000;
+const MAX_SAFE_BIGINT = BigInt(Number.MAX_SAFE_INTEGER);
 function stripTrailingSlash(value) {
     return value.replace(/\/+$/, "");
 }
@@ -18,9 +18,9 @@ function isIdentifier(value) {
 }
 function isNonNegativeInteger(value) {
     if (typeof value === "bigint") {
-        return value >= 0n;
+        return value >= 0n && value <= MAX_SAFE_BIGINT;
     }
-    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
 }
 function isHexKey(value) {
     return /^[a-fA-F0-9]{64}$/.test(value);
@@ -42,6 +42,30 @@ function asRecord(value) {
     }
     return value;
 }
+function isPlainObject(value) {
+    return Object.prototype.toString.call(value) === "[object Object]";
+}
+function validateTransactionJsonValue(value) {
+    if (value == null || typeof value === "string" || typeof value === "boolean") {
+        return true;
+    }
+    if (typeof value === "bigint") {
+        return true;
+    }
+    if (typeof value === "number") {
+        return Number.isSafeInteger(value);
+    }
+    if (value instanceof Uint8Array) {
+        return true;
+    }
+    if (Array.isArray(value)) {
+        return value.every((item) => validateTransactionJsonValue(item));
+    }
+    if (isPlainObject(value)) {
+        return Object.values(value).every((item) => validateTransactionJsonValue(item));
+    }
+    return false;
+}
 function parseJsonResult(value) {
     try {
         return JSON.parse(value);
@@ -65,17 +89,40 @@ function normalizeMaybeString(value) {
     }
     return typeof value === "string" ? value : String(value);
 }
-function normalizeMaybeXianNumber(value) {
+/**
+ * Coerce a chi_used value from a simulation response to a JS number.
+ *
+ * The simulator returns chi_used as either a number or a stringified
+ * integer. Historically we used Number.parseInt here, which silently
+ * truncates on scientific notation ("1e6" → 1), decimals ("1.5" → 1),
+ * and loses precision above 2^53 for large strings. parseXianNumber
+ * runs it through BigInt so oversized values are flagged. Chi values
+ * in practice fit comfortably inside Number.MAX_SAFE_INTEGER, so we
+ * collapse the bigint branch back to a number and throw only if the
+ * estimate is actually too large to represent safely — that can't
+ * happen today, but an explicit failure beats a silent mis-estimate.
+ */
+function coerceChiEstimate(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
     if (value == null) {
-        return null;
+        throw new Error("simulation response is missing chi_used");
     }
-    if (typeof value === "number" || typeof value === "bigint") {
-        return value;
+    const raw = String(value).trim();
+    if (raw === "") {
+        throw new Error("simulation response has empty chi_used");
     }
-    if (typeof value === "string" && /^-?\d+$/.test(value)) {
-        return parseXianNumber(value);
+    try {
+        const parsed = parseXianNumber(raw);
+        if (typeof parsed === "bigint") {
+            throw new Error(`chi_used estimate ${raw} exceeds Number.MAX_SAFE_INTEGER`);
+        }
+        return parsed;
+    }
+    catch (err) {
+        throw new Error(`invalid chi_used estimate ${JSON.stringify(value)}: ${err instanceof Error ? err.message : String(err)}`);
     }
-    return null;
 }
 function clampPageSize(value, fallback) {
     if (typeof value !== "number" || !Number.isFinite(value)) {
@@ -92,9 +139,36 @@ function clampOffset(value) {
 function isPendingLookupReceipt(receipt) {
     return !receipt.success && receipt.txHash == null && receipt.transaction == null;
 }
+/**
+ * Combine a caller-provided AbortSignal with a timeout-backed internal
+ * signal so either one triggering aborts the underlying fetch. We prefer
+ * AbortSignal.any when available; on older runtimes we stitch them
+ * together manually.
+ */
+export function mergeAbortSignals(a, b) {
+    if (!a)
+        return b;
+    if (!b)
+        return a;
+    const anyFn = AbortSignal.any;
+    if (typeof anyFn === "function") {
+        return anyFn([a, b]);
+    }
+    const controller = new AbortController();
+    const forward = (signal) => {
+        if (signal.aborted) {
+            controller.abort(signal.reason);
+            return;
+        }
+        signal.addEventListener("abort", () => controller.abort(signal.reason), { once: true });
+    };
+    forward(a);
+    forward(b);
+    return controller.signal;
+}
 function validatePayload(payload) {
     const keys = Object.keys(payload).sort();
-    const expected = ["chain_id", "contract", "function", "kwargs", "nonce", "sender", "stamps_supplied"];
+    const expected = ["chain_id", "chi_supplied", "contract", "function", "kwargs", "nonce", "sender"];
     if (keys.join(",") !== expected.join(",")) {
         throw new TransactionError("payload must contain the canonical Xian transaction keys");
     }
@@ -110,20 +184,27 @@ function validatePayload(payload) {
     if (!isNonNegativeInteger(payload.nonce)) {
         throw new TransactionError("nonce must be a non-negative integer");
     }
-    if (!isNonNegativeInteger(payload.stamps_supplied)) {
-        throw new TransactionError("stamps_supplied must be a non-negative integer");
+    if (!isNonNegativeInteger(payload.chi_supplied)) {
+        throw new TransactionError("chi_supplied must be a non-negative integer");
+    }
+    if (!isPlainObject(payload.kwargs)) {
+        throw new TransactionError("kwargs must be an object");
     }
     for (const key of Object.keys(payload.kwargs)) {
         if (!isIdentifier(key)) {
             throw new TransactionError("kwargs keys must be valid identifiers");
         }
     }
+    if (!validateTransactionJsonValue(payload.kwargs)) {
+        throw new TransactionError("kwargs values must be JSON-compatible transaction values");
+    }
 }
 export class XianClient {
     rpcUrl;
     dashboardUrl;
     watch;
     fetchFn;
+    requestTimeoutMs;
     chainIdCache;
     constructor(options) {
         this.rpcUrl = stripTrailingSlash(options.rpcUrl);
@@ -132,19 +213,43 @@ export class XianClient {
             : undefined;
         this.chainIdCache = options.chainId;
         this.fetchFn = options.fetchFn ?? globalThis.fetch.bind(globalThis);
+        this.requestTimeoutMs =
+            options.requestTimeoutMs ?? DEFAULT_TIMEOUT_MS;
         this.watch = new WatchApi({
             dashboardUrl: this.dashboardUrl,
             webSocketFactory: options.webSocketFactory
         });
     }
-    async requestJson(method, url) {
+    async requestJson(method, url, options) {
+        const timeoutMs = options?.timeoutMs ?? this.requestTimeoutMs;
+        const timeoutController = timeoutMs > 0 ? new AbortController() : undefined;
+        const timeoutHandle = timeoutController
+            ? setTimeout(() => timeoutController.abort(), timeoutMs)
+            : undefined;
+        const callerSignal = options?.signal;
+        const signal = mergeAbortSignals(callerSignal, timeoutController?.signal);
         let response;
         try {
-            response = await this.fetchFn(url, { method });
+            response = await this.fetchFn(url, {
+                method,
+                headers: method === "POST" ? { "content-type": "application/json" } : undefined,
+                signal,
+            });
         }
         catch (error) {
+            if (callerSignal?.aborted) {
+                throw error;
+            }
+            if (timeoutController?.signal.aborted) {
+                throw new TransportError(`request timed out after ${timeoutMs}ms for ${url}`, { cause: error });
+            }
             throw new TransportError(`request failed for ${url}`, { cause: error });
         }
+        finally {
+            if (timeoutHandle !== undefined) {
+                clearTimeout(timeoutHandle);
+            }
+        }
         if (!response.ok) {
             throw new TransportError(`${method} ${url} returned ${response.status}`);
         }
@@ -269,24 +374,24 @@ export class XianClient {
         }
     }
     async getTokenMetadata(contract) {
-        if (contract === "currency") {
-            return {
-                contract,
-                name: "Xian",
-                symbol: "Xian",
-                logoUrl: null
-            };
-        }
         const [name, symbol, logoUrl] = await Promise.all([
             this.getState(contract, "metadata", ["token_name"]),
             this.getState(contract, "metadata", ["token_symbol"]),
             this.getState(contract, "metadata", ["token_logo_url"])
         ]);
+        const rawLogoUrl = normalizeMaybeString(logoUrl);
+        const normalizedLogoUrl = rawLogoUrl?.trim() ? rawLogoUrl.trim() : null;
+        let logoSvg = null;
+        if (!normalizedLogoUrl) {
+            const rawLogoSvg = normalizeMaybeString(await this.getState(contract, "metadata", ["token_logo_svg"]).catch(() => null));
+            logoSvg = rawLogoSvg?.trim() ? rawLogoSvg.trim() : null;
+        }
         return {
             contract,
             name: normalizeMaybeString(name),
             symbol: normalizeMaybeString(symbol),
-            logoUrl: normalizeMaybeString(logoUrl)
+            logoUrl: normalizedLogoUrl,
+            logoSvg
         };
     }
     async getTokenBalances(address, options) {
@@ -323,8 +428,47 @@ export class XianClient {
             offset: Number(payload.offset ?? offset)
         };
     }
-    async getStampRate() {
-        const value = await this.getState("stamp_cost", "S", ["value"]);
+    async getShieldedWalletHistory(tagValue, options) {
+        const limit = clampPageSize(options?.limit, 100);
+        const afterNoteIndex = clampOffset(options?.afterNoteIndex);
+        const kind = typeof options?.kind === "string" && options.kind.trim().length > 0
+            ? options.kind.trim()
+            : "sync_hint";
+        const data = await this.abciQuery(`/shielded_wallet_history/${tagValue}/limit=${limit}/kind=${kind}/after_note_index=${afterNoteIndex}`);
+        const value = this.decodeAbciValue(asRecord(asRecord(data.result).response).value);
+        const payload = asRecord(value);
+        const items = Array.isArray(payload.items)
+            ? payload.items
+                .filter((item) => item != null && typeof item === "object")
+                .map((item) => ({
+                eventId: normalizeMaybeInteger(item.event_id),
+                txHash: normalizeMaybeString(item.tx_hash),
+                blockHeight: normalizeMaybeXianNumber(item.block_height),
+                txIndex: normalizeMaybeXianNumber(item.tx_index),
+                contract: normalizeMaybeString(item.contract),
+                function: normalizeMaybeString(item.function),
+                action: normalizeMaybeString(item.action),
+                outputIndex: normalizeMaybeXianNumber(item.output_index),
+                noteIndex: normalizeMaybeXianNumber(item.note_index),
+                commitment: normalizeMaybeString(item.commitment),
+                newRoot: normalizeMaybeString(item.new_root),
+                payloadHash: normalizeMaybeString(item.payload_hash),
+                tagKind: normalizeMaybeString(item.tag_kind),
+                tagValue: normalizeMaybeString(item.tag_value),
+                outputPayload: normalizeMaybeString(item.output_payload),
+                createdAt: normalizeMaybeString(item.created_at ?? item.created),
+                raw: item
+            }))
+            : [];
+        return {
+            available: payload.available !== false,
+            items,
+            limit: Number(payload.limit ?? limit),
+            afterNoteIndex: Number(payload.after_note_index ?? afterNoteIndex)
+        };
+    }
+    async getChiRate() {
+        const value = await this.getState("chi_cost", "S", ["value"]);
         if (value == null) {
             return null;
         }
@@ -333,16 +477,16 @@ export class XianClient {
         }
         return parseXianNumber(String(value));
     }
-    async getContract(contract) {
-        const data = await this.abciQuery(`/contract/${contract}`);
+    async getContractSource(contract) {
+        const data = await this.abciQuery(`/contract_source/${contract}`);
         const value = asRecord(asRecord(data.result).response).value;
         if (value == null || value === EMPTY_ABCI_VALUE) {
             return null;
         }
         return base64ToUtf8(String(value));
     }
-    async getContractCode(contract) {
-        const data = await this.abciQuery(`/contract_code/${contract}`);
+    async getContractIr(contract) {
+        const data = await this.abciQuery(`/contract_ir/${contract}`);
         const value = asRecord(asRecord(data.result).response).value;
         if (value == null || value === EMPTY_ABCI_VALUE) {
             return null;
@@ -405,34 +549,26 @@ export class XianClient {
         }
         return simulation.result;
     }
-    async estimateStamps(request, options) {
+    async estimateChi(request) {
         const simulation = await this.simulate(request);
-        const rawStamps = simulation.stamps_used;
-        const estimated = typeof rawStamps === "number"
-            ? rawStamps
-            : Number.parseInt(String(rawStamps ?? "0"), 10);
-        const stampMargin = options?.stampMargin ?? DEFAULT_STAMP_MARGIN;
-        const minStampHeadroom = options?.minStampHeadroom ?? DEFAULT_MIN_STAMP_HEADROOM;
-        const proportional = Math.ceil(estimated * stampMargin);
-        const suggested = estimated + Math.max(proportional, minStampHeadroom);
+        const estimated = coerceChiEstimate(simulation.chi_used);
         return {
             estimated,
-            suggested,
             simulation
         };
     }
     async buildTx(request) {
         const chainId = request.chainId ?? (await this.getChainId());
         const nonce = request.nonce ?? (await this.getNonce(request.sender));
-        let stampsSupplied = request.stampsSupplied ?? request.stamps;
-        if (stampsSupplied == null) {
-            const estimate = await this.estimateStamps({
+        let chiSupplied = request.chiSupplied ?? request.chi;
+        if (chiSupplied == null) {
+            const estimate = await this.estimateChi({
                 sender: request.sender,
                 contract: request.contract,
                 function: request.function,
                 kwargs: request.kwargs
             });
-            stampsSupplied = estimate.suggested;
+            chiSupplied = estimate.estimated;
         }
         const payload = sortKeysDeep({
             chain_id: chainId,
@@ -441,7 +577,7 @@ export class XianClient {
             kwargs: request.kwargs,
             nonce,
             sender: request.sender,
-            stamps_supplied: stampsSupplied
+            chi_supplied: chiSupplied
         });
         validatePayload(payload);
         return { payload };
@@ -486,7 +622,7 @@ export class XianClient {
             message: "error" in data ? readErrorMessage(asRecord(data.error)) : undefined,
             mode,
             nonce: tx.payload.nonce,
-            stampsSupplied: tx.payload.stamps_supplied,
+            chiSupplied: tx.payload.chi_supplied,
             response: data
         };
         if ("error" in data) {
@@ -550,6 +686,57 @@ export class XianClient {
             pollIntervalMs: request.pollIntervalMs
         });
     }
+    async submitContract(request) {
+        if (typeof request.signer.getAddress !== "function") {
+            throw new TransactionError("signer.getAddress() is required for contract submission");
+        }
+        if (!isPlainObject(request.deploymentArtifacts)) {
+            throw new TransactionError("deploymentArtifacts must be an object");
+        }
+        if ("runtime_code" in request.deploymentArtifacts) {
+            throw new TransactionError("deploymentArtifacts must not include runtime_code");
+        }
+        const hashes = request.deploymentArtifacts.hashes;
+        if (isPlainObject(hashes) && "runtime_code_sha256" in hashes) {
+            throw new TransactionError("deploymentArtifacts hashes must not include runtime_code_sha256");
+        }
+        const kwargs = {
+            name: request.name,
+            deployment_artifacts: request.deploymentArtifacts
+        };
+        if (request.args && Object.keys(request.args).length > 0) {
+            kwargs.constructor_args = request.args;
+        }
+        const sender = await request.signer.getAddress();
+        return this.sendTx({
+            sender,
+            contract: "submission",
+            function: "submit_contract",
+            kwargs,
+            signer: request.signer,
+            mode: request.mode,
+            waitForTx: request.waitForTx,
+            timeoutMs: request.timeoutMs,
+            pollIntervalMs: request.pollIntervalMs,
+            chi: request.chi,
+            nonce: request.nonce,
+            chainId: request.chainId
+        });
+    }
+    async deployContract(request) {
+        const { source, compiler, lint, vmProfile, ...submitRequest } = request;
+        const deploymentArtifacts = await compileContractArtifacts({
+            moduleName: request.name,
+            source,
+            compiler,
+            lint,
+            vmProfile
+        });
+        return this.submitContract({
+            ...submitRequest,
+            deploymentArtifacts
+        });
+    }
     contract(name) {
         return new ContractClient(this, name);
     }
@@ -594,7 +781,7 @@ export class ContractClient {
             waitForTx: options.waitForTx,
             timeoutMs: options.timeoutMs,
             pollIntervalMs: options.pollIntervalMs,
-            stamps: options.stamps,
+            chi: options.chi,
             nonce: options.nonce,
             chainId: options.chainId
         });
@@ -634,7 +821,7 @@ export class TokenClient {
             waitForTx: options.waitForTx,
             timeoutMs: options.timeoutMs,
             pollIntervalMs: options.pollIntervalMs,
-            stamps: options.stamps,
+            chi: options.chi,
             nonce: options.nonce,
             chainId: options.chainId
         });
@@ -657,7 +844,7 @@ export class TokenClient {
             waitForTx: options.waitForTx,
             timeoutMs: options.timeoutMs,
             pollIntervalMs: options.pollIntervalMs,
-            stamps: options.stamps,
+            chi: options.chi,
             nonce: options.nonce,
             chainId: options.chainId
         });