@perkos/agent-sdk 0.1.0

package/dist/policy.js.map

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

package/dist/signers.d.ts

@@ -0,0 +1,51 @@
+import type { ClarityValue, PostCondition, PostConditionModeName } from "@stacks/transactions";
+import type { ContractCallPlan, ContractId, PerkOSNetwork, PerkOSSigner, SignerResult } from "./types.js";
+export type PrivateKeyMaterial = string | Uint8Array;
+export type PrivateKeyProvider = () => PrivateKeyMaterial | Promise<PrivateKeyMaterial>;
+export interface HeadlessTransactionRequest {
+    readonly plan: ContractCallPlan;
+    readonly privateKey: PrivateKeyMaterial;
+    readonly apiUrl?: string;
+}
+export type HeadlessTransactionExecutor = (request: HeadlessTransactionRequest) => Promise<SignerResult>;
+export interface HeadlessSignerOptions {
+    readonly network: PerkOSNetwork;
+    readonly privateKeyProvider: PrivateKeyProvider;
+    readonly apiUrl?: string;
+    readonly transactionExecutor?: HeadlessTransactionExecutor;
+}
+export declare class HeadlessSigner implements PerkOSSigner {
+    private readonly network;
+    private readonly privateKeyProvider;
+    private readonly apiUrl;
+    private readonly transactionExecutor;
+    private address;
+    constructor(options: HeadlessSignerOptions);
+    getAddress(): Promise<string>;
+    signAndBroadcast(plan: ContractCallPlan): Promise<SignerResult>;
+    private withPrivateKey;
+}
+export interface StacksConnectContractCallParams {
+    readonly contract: ContractId;
+    readonly functionName: string;
+    readonly functionArgs: readonly ClarityValue[];
+    readonly network: PerkOSNetwork;
+    readonly postConditions: readonly PostCondition[];
+    readonly postConditionMode: PostConditionModeName;
+    readonly sponsored: boolean;
+}
+export type StacksConnectRequest = (method: "stx_callContract", params: StacksConnectContractCallParams) => Promise<unknown>;
+export interface StacksConnectSignerOptions {
+    readonly network: PerkOSNetwork;
+    readonly address: string;
+    readonly request: StacksConnectRequest;
+}
+export declare class StacksConnectSigner implements PerkOSSigner {
+    private readonly network;
+    private readonly address;
+    private readonly request;
+    constructor(options: StacksConnectSignerOptions);
+    getAddress(): Promise<string>;
+    signAndBroadcast(plan: ContractCallPlan): Promise<SignerResult>;
+}
+//# sourceMappingURL=signers.d.ts.map

package/dist/signers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signers.d.ts","sourceRoot":"","sources":["../src/signers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAOpB,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,CAAC;AACrD,MAAM,MAAM,kBAAkB,GAAG,MAC7B,kBAAkB,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEhC,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,2BAA2B,GAAG,CACxC,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,YAAY,CAAC,CAAC;AAE3B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;CAC5D;AAuCD,qBAAa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8B;IAClE,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,EAAE,qBAAqB;IAgBpC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAU7B,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;YAiBvD,cAAc;CA4B7B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;IAClD,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,+BAA+B,KACpC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AA0BD,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAEnC,OAAO,EAAE,0BAA0B;IAazC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;CA2BtE"}

package/dist/signers.js

@@ -0,0 +1,145 @@
+import { broadcastTransaction, getAddressFromPrivateKey, makeContractCall, } from "@stacks/transactions";
+import { PerkOSError } from "./errors.js";
+import { normalizeTxid } from "./txid.js";
+import { assertPrincipal, normalizeApiUrl, parseContractId, } from "./validation.js";
+async function defaultHeadlessExecutor(request) {
+    const { address, name } = parseContractId(request.plan.contract, "plan.contract", request.plan.network);
+    const client = request.apiUrl
+        ? { client: { baseUrl: request.apiUrl } }
+        : {};
+    const transaction = await makeContractCall({
+        contractAddress: address,
+        contractName: name,
+        functionName: request.plan.functionName,
+        functionArgs: [...request.plan.functionArgs],
+        senderKey: request.privateKey,
+        network: request.plan.network,
+        postConditions: [...request.plan.postConditions],
+        postConditionMode: request.plan.postConditionMode,
+        ...client,
+    });
+    const result = await broadcastTransaction({
+        transaction,
+        network: request.plan.network,
+        ...client,
+    });
+    if ("error" in result) {
+        throw new PerkOSError("BROADCAST_REJECTED", `Stacks rejected the transaction: ${result.reason}.`, { raw: result, reason: result.reason });
+    }
+    return { txid: normalizeTxid(result.txid), raw: result };
+}
+export class HeadlessSigner {
+    network;
+    privateKeyProvider;
+    apiUrl;
+    transactionExecutor;
+    address;
+    constructor(options) {
+        if (typeof options.privateKeyProvider !== "function") {
+            throw new PerkOSError("CONFIG_INVALID", "HeadlessSigner requires a privateKeyProvider callback.");
+        }
+        this.network = options.network;
+        this.privateKeyProvider = options.privateKeyProvider;
+        this.apiUrl = options.apiUrl
+            ? normalizeApiUrl(options.apiUrl, "HeadlessSigner apiUrl")
+            : undefined;
+        this.transactionExecutor =
+            options.transactionExecutor ?? defaultHeadlessExecutor;
+    }
+    async getAddress() {
+        if (this.address)
+            return this.address;
+        const address = await this.withPrivateKey((privateKey) => getAddressFromPrivateKey(privateKey, this.network));
+        assertPrincipal(address, "headless signer address", this.network);
+        this.address = address;
+        return address;
+    }
+    async signAndBroadcast(plan) {
+        if (plan.network !== this.network) {
+            throw new PerkOSError("SIGNER_MISMATCH", `HeadlessSigner is configured for ${this.network}, not ${plan.network}.`);
+        }
+        const result = await this.withPrivateKey((privateKey) => this.transactionExecutor({
+            plan,
+            privateKey,
+            ...(this.apiUrl ? { apiUrl: this.apiUrl } : {}),
+        }));
+        return { ...result, txid: normalizeTxid(result.txid) };
+    }
+    async withPrivateKey(operation) {
+        let privateKey;
+        try {
+            const supplied = await this.privateKeyProvider();
+            privateKey =
+                typeof supplied === "string"
+                    ? supplied.trim()
+                    : Uint8Array.from(supplied);
+            if (privateKey.length === 0) {
+                throw new PerkOSError("SIGNING_FAILED", "privateKeyProvider returned empty key material.");
+            }
+            return await operation(privateKey);
+        }
+        catch (cause) {
+            if (cause instanceof PerkOSError)
+                throw cause;
+            throw new PerkOSError("SIGNING_FAILED", "HeadlessSigner could not use the supplied key material.", { cause });
+        }
+        finally {
+            if (privateKey instanceof Uint8Array)
+                privateKey.fill(0);
+        }
+    }
+}
+function extractConnectTxid(result) {
+    if (!result || typeof result !== "object") {
+        throw new PerkOSError("BROADCAST_REJECTED", "Stacks Connect returned an invalid transaction result.", { raw: result });
+    }
+    const record = result;
+    const nested = record.result && typeof record.result === "object"
+        ? record.result
+        : undefined;
+    const candidate = record.txid ?? record.txId ?? nested?.txid ?? nested?.txId;
+    if (typeof candidate !== "string") {
+        throw new PerkOSError("BROADCAST_REJECTED", "Stacks Connect did not return a transaction ID.", { raw: result });
+    }
+    return normalizeTxid(candidate);
+}
+export class StacksConnectSigner {
+    network;
+    address;
+    request;
+    constructor(options) {
+        assertPrincipal(options.address, "Stacks Connect address", options.network);
+        if (typeof options.request !== "function") {
+            throw new PerkOSError("CONFIG_INVALID", "StacksConnectSigner requires the Stacks Connect request function.");
+        }
+        this.network = options.network;
+        this.address = options.address;
+        this.request = options.request;
+    }
+    async getAddress() {
+        return this.address;
+    }
+    async signAndBroadcast(plan) {
+        if (plan.network !== this.network) {
+            throw new PerkOSError("SIGNER_MISMATCH", `StacksConnectSigner is configured for ${this.network}, not ${plan.network}.`);
+        }
+        try {
+            const result = await this.request("stx_callContract", {
+                contract: plan.contract,
+                functionName: plan.functionName,
+                functionArgs: [...plan.functionArgs],
+                network: plan.network,
+                postConditions: [...plan.postConditions],
+                postConditionMode: plan.postConditionMode,
+                sponsored: false,
+            });
+            return { txid: extractConnectTxid(result), raw: result };
+        }
+        catch (cause) {
+            if (cause instanceof PerkOSError)
+                throw cause;
+            throw new PerkOSError("SIGNING_FAILED", "Stacks Connect rejected or cancelled the contract call.", { cause, contract: plan.contract, functionName: plan.functionName });
+        }
+    }
+}
+//# sourceMappingURL=signers.js.map

package/dist/signers.js.map

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

package/dist/tracker.d.ts

@@ -0,0 +1,21 @@
+import type { ConfirmationOptions, PerkOSNetwork, TransactionConfirmation, TransactionTrackerLike } from "./types.js";
+export type TrackerFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export interface TransactionTrackerOptions {
+    readonly network: PerkOSNetwork;
+    readonly apiUrl?: string;
+    readonly fetch?: TrackerFetch;
+    readonly sleep?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+    readonly now?: () => number;
+}
+export declare class TransactionTracker implements TransactionTrackerLike {
+    private readonly network;
+    private readonly apiUrl;
+    private readonly fetch;
+    private readonly sleep;
+    private readonly now;
+    constructor(options: TransactionTrackerOptions);
+    getStatus(txidInput: string): Promise<TransactionConfirmation>;
+    private getExecutionResult;
+    waitForConfirmation(txidInput: string, options?: ConfirmationOptions): Promise<TransactionConfirmation>;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EAGvB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAuED,qBAAa,kBAAmB,YAAW,sBAAsB;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGH;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,OAAO,EAAE,yBAAyB;IAWxC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;YA2EtD,kBAAkB;IAkB1B,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;CAuCpC"}

package/dist/tracker.js

@@ -0,0 +1,175 @@
+import { PerkOSError } from "./errors.js";
+import { normalizeTxid } from "./txid.js";
+import { normalizeApiUrl } from "./validation.js";
+const DEFAULT_API_URL = {
+    mainnet: "https://api.hiro.so",
+    testnet: "https://api.testnet.hiro.so",
+};
+function statusFromApi(value) {
+    if (typeof value !== "string") {
+        throw new PerkOSError("CONFIRMATION_FAILED", "The transaction API returned no status.");
+    }
+    const status = value.toLowerCase();
+    if (status === "success")
+        return "success";
+    if (status === "pending" || status === "mempool")
+        return "pending";
+    if (status.startsWith("abort"))
+        return "abort";
+    if (status.startsWith("drop"))
+        return "dropped";
+    throw new PerkOSError("CONFIRMATION_FAILED", `The transaction API returned an unknown status: ${value}.`);
+}
+function optionalNumber(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return undefined;
+    return value;
+}
+function optionalString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function resultFromApi(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const record = value;
+    const hex = optionalString(record.hex);
+    const repr = optionalString(record.repr);
+    if (!hex && !repr)
+        return undefined;
+    return { ...(hex ? { hex } : {}), ...(repr ? { repr } : {}) };
+}
+function abortError() {
+    return new PerkOSError("CONFIRMATION_FAILED", "Transaction confirmation was cancelled.");
+}
+async function defaultSleep(milliseconds, signal) {
+    if (signal?.aborted)
+        throw abortError();
+    await new Promise((resolve, reject) => {
+        const cleanup = () => signal?.removeEventListener("abort", onAbort);
+        const finish = () => {
+            cleanup();
+            resolve();
+        };
+        const timer = setTimeout(finish, milliseconds);
+        const onAbort = () => {
+            clearTimeout(timer);
+            cleanup();
+            reject(abortError());
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export class TransactionTracker {
+    network;
+    apiUrl;
+    fetch;
+    sleep;
+    now;
+    constructor(options) {
+        this.network = options.network;
+        this.apiUrl = normalizeApiUrl(options.apiUrl ?? DEFAULT_API_URL[options.network], "TransactionTracker apiUrl");
+        this.fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.sleep = options.sleep ?? defaultSleep;
+        this.now = options.now ?? Date.now;
+    }
+    async getStatus(txidInput) {
+        const txid = normalizeTxid(txidInput);
+        let response;
+        try {
+            response = await this.fetch(`${this.apiUrl}/extended/v3/transactions/${encodeURIComponent(txid)}`, { headers: { accept: "application/json" } });
+        }
+        catch (cause) {
+            throw new PerkOSError("CONFIRMATION_FAILED", "Could not reach the Stacks transaction API.", { cause, txid });
+        }
+        const observedAt = new Date(this.now()).toISOString();
+        if (response.status === 404) {
+            return {
+                txid,
+                network: this.network,
+                status: "pending",
+                observedAt,
+            };
+        }
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new PerkOSError("CONFIRMATION_FAILED", `Transaction API returned HTTP ${response.status}.`, { txid, status: response.status, body: body.slice(0, 500) });
+        }
+        let raw;
+        try {
+            raw = await response.json();
+        }
+        catch (cause) {
+            throw new PerkOSError("CONFIRMATION_FAILED", "Transaction API returned invalid JSON.", { cause, txid });
+        }
+        if (!raw || typeof raw !== "object") {
+            throw new PerkOSError("CONFIRMATION_FAILED", "Transaction API returned an invalid response.", { txid, raw });
+        }
+        const record = raw;
+        const block = record.block && typeof record.block === "object"
+            ? record.block
+            : undefined;
+        const status = statusFromApi(record.status ?? record.tx_status);
+        let result = resultFromApi(record.result ?? record.tx_result);
+        if (!result && status !== "pending") {
+            result = await this.getExecutionResult(txid);
+        }
+        const blockHeight = optionalNumber(block?.height ?? record.block_height);
+        const blockHash = optionalString(block?.hash ?? record.block_hash);
+        return {
+            txid,
+            network: this.network,
+            status,
+            observedAt,
+            ...(blockHeight !== undefined ? { blockHeight } : {}),
+            ...(blockHash ? { blockHash } : {}),
+            ...(result ? { result } : {}),
+            raw,
+        };
+    }
+    async getExecutionResult(txid) {
+        try {
+            const response = await this.fetch(`${this.apiUrl}/extended/v1/tx/${encodeURIComponent(txid)}`, { headers: { accept: "application/json" } });
+            if (!response.ok)
+                return undefined;
+            const raw = await response.json();
+            if (!raw || typeof raw !== "object")
+                return undefined;
+            const record = raw;
+            return resultFromApi(record.tx_result ?? record.result);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async waitForConfirmation(txidInput, options = {}) {
+        const txid = normalizeTxid(txidInput);
+        const pollIntervalMs = options.pollIntervalMs ?? 5_000;
+        const timeoutMs = options.timeoutMs ?? 10 * 60_000;
+        if (!Number.isFinite(pollIntervalMs) || pollIntervalMs < 1) {
+            throw new PerkOSError("CONFIG_INVALID", "pollIntervalMs must be at least 1 millisecond.");
+        }
+        if (!Number.isFinite(timeoutMs) || timeoutMs < 1) {
+            throw new PerkOSError("CONFIG_INVALID", "timeoutMs must be at least 1 millisecond.");
+        }
+        const startedAt = this.now();
+        let last;
+        while (true) {
+            if (options.signal?.aborted)
+                throw abortError();
+            last = await this.getStatus(txid);
+            await options.onStatus?.(last);
+            if (last.status !== "pending")
+                return last;
+            const elapsed = this.now() - startedAt;
+            if (elapsed >= timeoutMs) {
+                return {
+                    ...last,
+                    status: "timeout",
+                    observedAt: new Date(this.now()).toISOString(),
+                };
+            }
+            await this.sleep(Math.min(pollIntervalMs, Math.max(1, timeoutMs - elapsed)), options.signal);
+        }
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAS1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAelD,MAAM,eAAe,GAA4C;IAC/D,OAAO,EAAE,qBAAqB;IAC9B,OAAO,EAAE,6BAA6B;CACvC,CAAC;AAEF,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,WAAW,CACnB,qBAAqB,EACrB,yCAAyC,CAC1C,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACnE,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,IAAI,WAAW,CACnB,qBAAqB,EACrB,mDAAmD,KAAK,GAAG,CAC5D,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,IAAI,WAAW,CACpB,qBAAqB,EACrB,yCAAyC,CAC1C,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,YAAoB,EACpB,MAAoB;IAEpB,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,UAAU,EAAE,CAAC;IACxC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvB,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAgB;IACvB,MAAM,CAAS;IACf,KAAK,CAAe;IACpB,KAAK,CAGH;IACF,GAAG,CAAe;IAEnC,YAAY,OAAkC;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,eAAe,CAC3B,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,EAClD,2BAA2B,CAC5B,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;QAC3C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAiB;QAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CACzB,GAAG,IAAI,CAAC,MAAM,6BAA6B,kBAAkB,CAAC,IAAI,CAAC,EAAE,EACrE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAC5C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CACnB,qBAAqB,EACrB,6CAA6C,EAC7C,EAAE,KAAK,EAAE,IAAI,EAAE,CAChB,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACtD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,SAAS;gBACjB,UAAU;aACX,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,WAAW,CACnB,qBAAqB,EACrB,iCAAiC,QAAQ,CAAC,MAAM,GAAG,EACnD,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC5D,CAAC;QACJ,CAAC;QAED,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CACnB,qBAAqB,EACrB,wCAAwC,EACxC,EAAE,KAAK,EAAE,IAAI,EAAE,CAChB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,WAAW,CACnB,qBAAqB,EACrB,+CAA+C,EAC/C,EAAE,IAAI,EAAE,GAAG,EAAE,CACd,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,GAA8B,CAAC;QAC9C,MAAM,KAAK,GACT,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAC9C,CAAC,CAAE,MAAM,CAAC,KAAiC;YAC3C,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;QACzE,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;QACnE,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM;YACN,UAAU;YACV,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG;SACJ,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,IAAY;QAEZ,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAC/B,GAAG,IAAI,CAAC,MAAM,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAC3D,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAC5C,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,SAAS,CAAC;YACnC,MAAM,GAAG,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YACtD,MAAM,MAAM,GAAG,GAA8B,CAAC;YAC9C,OAAO,aAAa,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,SAAiB,EACjB,UAA+B,EAAE;QAEjC,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;QACvD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,GAAG,MAAM,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,WAAW,CACnB,gBAAgB,EAChB,gDAAgD,CACjD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,WAAW,CACnB,gBAAgB,EAChB,2CAA2C,CAC5C,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,IAAyC,CAAC;QAC9C,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;gBAAE,MAAM,UAAU,EAAE,CAAC;YAChD,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YAE3C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACvC,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;gBACzB,OAAO;oBACL,GAAG,IAAI;oBACP,MAAM,EAAE,SAAS;oBACjB,UAAU,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;iBAC/C,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CACd,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,EAC1D,OAAO,CAAC,MAAM,CACf,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/txid.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeTxid(value: string): string;
+//# sourceMappingURL=txid.d.ts.map

package/dist/txid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"txid.d.ts","sourceRoot":"","sources":["../src/txid.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBnD"}

package/dist/txid.js

@@ -0,0 +1,13 @@
+import { PerkOSError } from "./errors.js";
+const TXID = /^[0-9a-f]{64}$/i;
+export function normalizeTxid(value) {
+    if (typeof value !== "string") {
+        throw new PerkOSError("BROADCAST_REJECTED", "The signer returned no Stacks transaction ID.", { txid: value });
+    }
+    const hex = value.trim().replace(/^0x/i, "");
+    if (!TXID.test(hex)) {
+        throw new PerkOSError("BROADCAST_REJECTED", "The signer returned an invalid Stacks transaction ID.", { txid: value });
+    }
+    return `0x${hex.toLowerCase()}`;
+}
+//# sourceMappingURL=txid.js.map

package/dist/txid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"txid.js","sourceRoot":"","sources":["../src/txid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAE/B,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,WAAW,CACnB,oBAAoB,EACpB,+CAA+C,EAC/C,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,WAAW,CACnB,oBAAoB,EACpB,uDAAuD,EACvD,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;AAClC,CAAC"}