@andrewkimjoseph/celina-sdk 0.15.1 → 0.15.2

package/build/src/tools/website-sync.js

@@ -0,0 +1,198 @@
+import { ALL_TOOL_DEFINITIONS, getToolInputSchemaShape } from "./catalog.js";
+import { filterToolDefinitions } from "./filter.js";
+export const HOSTED_MCP_FILTER = {
+    surface: "mcp",
+    serverKeyToolsEnabled: false,
+    selfSessionToolsEnabled: false,
+    estimateToolsEnabled: false,
+};
+const STDIO_ONLY_TOOLS = new Set([
+    "send_token",
+    "execute_mento_fx",
+    "execute_uniswap_swap",
+    "supply_aave",
+    "withdraw_aave",
+    "claim_daily_gooddollar_ubi",
+    "execute_gooddollar_reserve_swap",
+    "get_wallet_address",
+    "get_self_identity",
+    "sign_self_request",
+    "authenticated_self_fetch",
+    "refresh_self_proof",
+    "deregister_self_agent",
+    "register_self_agent",
+    "check_self_registration",
+]);
+export const TOOL_CATEGORY_BY_NAME = {
+    get_network_status: "Blockchain",
+    get_block: "Blockchain",
+    get_latest_blocks: "Blockchain",
+    get_transaction: "Blockchain",
+    verify_attribution_tag: "Blockchain",
+    check_attribution_tag: "Blockchain",
+    get_account: "Account",
+    get_wallet_address: "Wallet",
+    get_celo_balances: "Token",
+    get_stablecoin_balances: "Token",
+    get_token_info: "Token",
+    get_token_balance: "Token",
+    estimate_send: "Transaction",
+    send_token: "Transaction",
+    get_mento_fx_quote: "Mento FX",
+    estimate_mento_fx: "Mento FX",
+    execute_mento_fx: "Mento FX",
+    prepare_mento_fx: "Mento FX",
+    get_uniswap_quote: "Uniswap",
+    estimate_uniswap_swap: "Uniswap",
+    execute_uniswap_swap: "Uniswap",
+    prepare_uniswap_swap: "Uniswap",
+    get_swap_quote: "Uniswap",
+    prepare_swap: "Uniswap",
+    get_aave_balances: "Aave",
+    supply_aave: "Aave",
+    withdraw_aave: "Aave",
+    resolve_ens: "Wallet",
+    get_gooddollar_whitelisting_info: "GoodDollar",
+    get_gooddollar_identity_link: "GoodDollar",
+    get_gooddollar_ubi_entitlement: "GoodDollar",
+    claim_daily_gooddollar_ubi: "GoodDollar",
+    prepare_claim_daily_gooddollar_ubi: "GoodDollar",
+    get_gooddollar_reserve_quote: "GoodDollar",
+    estimate_gooddollar_reserve_swap: "GoodDollar",
+    execute_gooddollar_reserve_swap: "GoodDollar",
+    prepare_gooddollar_reserve_swap: "GoodDollar",
+    get_governance_proposals: "Governance",
+    get_proposal_details: "Governance",
+    get_staking_balances: "Staking",
+    get_validator_groups: "Staking",
+    get_validator_group_details: "Staking",
+    get_activatable_stakes: "Staking",
+    get_total_staking_info: "Staking",
+    get_nft_info: "NFT",
+    get_nft_balance: "NFT",
+    call_contract_function: "Contract",
+    estimate_contract_gas: "Contract",
+    verify_self_agent: "Self",
+    lookup_self_agent: "Self",
+    verify_self_request: "Self",
+    register_self_agent: "Self",
+    check_self_registration: "Self",
+    get_self_identity: "Self",
+    refresh_self_proof: "Self",
+    deregister_self_agent: "Self",
+    sign_self_request: "Self",
+    authenticated_self_fetch: "Self",
+    get_agentkarma_reputation: "AgentKarma",
+    get_agentkarma_celo_agent: "AgentKarma",
+    check_agentkarma_counterparty: "AgentKarma",
+};
+function toolNameToSlug(name) {
+    return name.replace(/_/g, "-");
+}
+function familyToKind(families) {
+    return families.includes("execute") ? "write" : "read";
+}
+function firstSentence(text) {
+    const match = text.match(/^[^.!?]+[.!?]?/);
+    return match ? match[0].trim() : text.slice(0, 120);
+}
+function unwrapZodSchema(schema) {
+    if (!schema || typeof schema !== "object") {
+        return null;
+    }
+    return schema;
+}
+function isZodOptional(schema) {
+    const zod = unwrapZodSchema(schema);
+    const typeName = zod?._def?.typeName;
+    return typeName === "ZodOptional" || typeName === "ZodDefault";
+}
+function zodInnerSchema(schema) {
+    const zod = unwrapZodSchema(schema);
+    if (!zod?._def)
+        return schema;
+    if (isZodOptional(schema)) {
+        return zod._def.innerType;
+    }
+    return schema;
+}
+function zodFieldType(schema) {
+    const inner = zodInnerSchema(schema);
+    const zod = unwrapZodSchema(inner);
+    if (!zod?._def?.typeName) {
+        return "string";
+    }
+    const typeName = zod._def.typeName;
+    if (typeName === "ZodBoolean")
+        return "boolean";
+    if (typeName === "ZodNumber")
+        return "number";
+    if (typeName === "ZodArray")
+        return "array";
+    return "string";
+}
+function zodFieldDescription(schema, fallback) {
+    const zod = unwrapZodSchema(schema);
+    if (zod?._def?.description) {
+        return zod._def.description;
+    }
+    if (isZodOptional(schema)) {
+        return zodFieldDescription(zod?._def?.innerType, fallback);
+    }
+    return fallback;
+}
+function inputsFromSchema(definition) {
+    const shape = getToolInputSchemaShape(definition);
+    if (!shape)
+        return [];
+    return Object.entries(shape).map(([name, schema]) => ({
+        name,
+        type: zodFieldType(schema),
+        required: !isZodOptional(schema),
+        description: zodFieldDescription(schema, name.replace(/_/g, " ")),
+    }));
+}
+function categoryForTool(definition) {
+    return TOOL_CATEGORY_BY_NAME[definition.name] ?? "Blockchain";
+}
+export function toWebsiteToolBaseline(definition) {
+    return {
+        name: definition.name,
+        slug: toolNameToSlug(definition.name),
+        title: definition.mcp?.title ?? definition.name.replace(/_/g, " "),
+        summary: firstSentence(definition.description),
+        description: definition.description,
+        kind: familyToKind(definition.families),
+        category: categoryForTool(definition),
+        inputs: inputsFromSchema(definition),
+    };
+}
+export function deriveToolAvailability(definition) {
+    if (definition.name.startsWith("estimate_")) {
+        return "stdio";
+    }
+    if (STDIO_ONLY_TOOLS.has(definition.name)) {
+        return "stdio";
+    }
+    const surfaces = definition.surfaces ?? ["mcp", "browser"];
+    if (surfaces.length === 1 && surfaces[0] === "browser") {
+        return "stdio";
+    }
+    return "both";
+}
+export function getHostedMcpToolDefinitions() {
+    return filterToolDefinitions(ALL_TOOL_DEFINITIONS, HOSTED_MCP_FILTER);
+}
+export function getHostedMcpToolNames() {
+    return getHostedMcpToolDefinitions().map((d) => d.name);
+}
+export function getHostedMcpToolCount() {
+    return getHostedMcpToolDefinitions().length;
+}
+export function getWebsiteToolBaselines() {
+    return filterToolDefinitions(ALL_TOOL_DEFINITIONS, { surface: "mcp" }).map(toWebsiteToolBaseline);
+}
+export function getMcpToolNameSet() {
+    return new Set(filterToolDefinitions(ALL_TOOL_DEFINITIONS, { surface: "mcp" }).map((d) => d.name));
+}
+//# sourceMappingURL=website-sync.js.map

package/build/src/tools/website-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-sync.js","sourceRoot":"","sources":["../../../src/tools/website-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAwCpD,MAAM,CAAC,MAAM,iBAAiB,GAAuB;IACnD,OAAO,EAAE,KAAK;IACd,qBAAqB,EAAE,KAAK;IAC5B,uBAAuB,EAAE,KAAK;IAC9B,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,YAAY;IACZ,kBAAkB;IAClB,sBAAsB;IACtB,aAAa;IACb,eAAe;IACf,4BAA4B;IAC5B,iCAAiC;IACjC,oBAAoB;IACpB,mBAAmB;IACnB,mBAAmB;IACnB,0BAA0B;IAC1B,oBAAoB;IACpB,uBAAuB;IACvB,qBAAqB;IACrB,yBAAyB;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAwC;IACxE,kBAAkB,EAAE,YAAY;IAChC,SAAS,EAAE,YAAY;IACvB,iBAAiB,EAAE,YAAY;IAC/B,eAAe,EAAE,YAAY;IAC7B,sBAAsB,EAAE,YAAY;IACpC,qBAAqB,EAAE,YAAY;IACnC,WAAW,EAAE,SAAS;IACtB,kBAAkB,EAAE,QAAQ;IAC5B,iBAAiB,EAAE,OAAO;IAC1B,uBAAuB,EAAE,OAAO;IAChC,cAAc,EAAE,OAAO;IACvB,iBAAiB,EAAE,OAAO;IAC1B,aAAa,EAAE,aAAa;IAC5B,UAAU,EAAE,aAAa;IACzB,kBAAkB,EAAE,UAAU;IAC9B,iBAAiB,EAAE,UAAU;IAC7B,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,UAAU;IAC5B,iBAAiB,EAAE,SAAS;IAC5B,qBAAqB,EAAE,SAAS;IAChC,oBAAoB,EAAE,SAAS;IAC/B,oBAAoB,EAAE,SAAS;IAC/B,cAAc,EAAE,SAAS;IACzB,YAAY,EAAE,SAAS;IACvB,iBAAiB,EAAE,MAAM;IACzB,WAAW,EAAE,MAAM;IACnB,aAAa,EAAE,MAAM;IACrB,WAAW,EAAE,QAAQ;IACrB,gCAAgC,EAAE,YAAY;IAC9C,4BAA4B,EAAE,YAAY;IAC1C,8BAA8B,EAAE,YAAY;IAC5C,0BAA0B,EAAE,YAAY;IACxC,kCAAkC,EAAE,YAAY;IAChD,4BAA4B,EAAE,YAAY;IAC1C,gCAAgC,EAAE,YAAY;IAC9C,+BAA+B,EAAE,YAAY;IAC7C,+BAA+B,EAAE,YAAY;IAC7C,wBAAwB,EAAE,YAAY;IACtC,oBAAoB,EAAE,YAAY;IAClC,oBAAoB,EAAE,SAAS;IAC/B,oBAAoB,EAAE,SAAS;IAC/B,2BAA2B,EAAE,SAAS;IACtC,sBAAsB,EAAE,SAAS;IACjC,sBAAsB,EAAE,SAAS;IACjC,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;IACtB,sBAAsB,EAAE,UAAU;IAClC,qBAAqB,EAAE,UAAU;IACjC,iBAAiB,EAAE,MAAM;IACzB,iBAAiB,EAAE,MAAM;IACzB,mBAAmB,EAAE,MAAM;IAC3B,mBAAmB,EAAE,MAAM;IAC3B,uBAAuB,EAAE,MAAM;IAC/B,iBAAiB,EAAE,MAAM;IACzB,kBAAkB,EAAE,MAAM;IAC1B,qBAAqB,EAAE,MAAM;IAC7B,iBAAiB,EAAE,MAAM;IACzB,wBAAwB,EAAE,MAAM;IAChC,yBAAyB,EAAE,YAAY;IACvC,yBAAyB,EAAE,YAAY;IACvC,6BAA6B,EAAE,YAAY;CAC5C,CAAC;AAEF,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,YAAY,CAAC,QAAsB;IAC1C,OAAO,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACzD,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC;AAUD,SAAS,eAAe,CAAC,MAAe;IACtC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAuB,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,MAAe;IACpC,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC;IACrC,OAAO,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,YAAY,CAAC;AACjE,CAAC;AAED,SAAS,cAAc,CAAC,MAAe;IACrC,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,IAAI;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,MAAe;IACnC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;IACnC,IAAI,QAAQ,KAAK,YAAY;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,QAAQ,KAAK,WAAW;QAAE,OAAO,QAAQ,CAAC;IAC9C,IAAI,QAAQ,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IAC5C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAe,EAAE,QAAgB;IAC5D,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC3B,OAAO,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC;IAC9B,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,mBAAmB,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,UAA0B;IAClD,MAAM,KAAK,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI;QACJ,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC;QAC1B,QAAQ,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC;QAChC,WAAW,EAAE,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;KAClE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,eAAe,CAAC,UAA0B;IACjD,OAAO,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAA0B;IAC9D,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC;QACrC,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;QAClE,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,WAAW,CAAC;QAC9C,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC;QACvC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC;QACrC,MAAM,EAAE,gBAAgB,CAAC,UAAU,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAA0B;IAE1B,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC3D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,qBAAqB,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,2BAA2B,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,2BAA2B,EAAE,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,qBAAqB,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CACxE,qBAAqB,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,GAAG,CACZ,qBAAqB,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CACjE,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAC9B,CACF,CAAC;AACJ,CAAC"}

package/build/src/types/prepared.d.ts

@@ -0,0 +1,43 @@
+import { CHAIN } from "../config/chains.js";
+export type PreparedTxKind = "native" | "erc20" | "contract";
+/**
+ * One unsigned transaction in a prepared list (`steps`).
+ * Calldata may already include Celina dual attribution suffixes from `prepare*`.
+ */
+export interface PreparedTx {
+    /** Step category for UI and wallet routing. */
+    kind: PreparedTxKind;
+    to: `0x${string}`;
+    data?: `0x${string}`;
+    /** Wei amount as decimal string for JSON serialization */
+    value?: string;
+    description: string;
+}
+/**
+ * Prepared flow = ordered unsigned transactions ready to sign (wagmi/EOA) or
+ * submit as UserOps (`createAAClient.sendPreparedFlow`) — not a runtime workflow engine.
+ * The primary payload is `steps`.
+ */
+export interface PreparedFlow {
+    steps: PreparedTx[];
+    summary: string;
+    /** Celo chain id (`celo.id` / {@link CHAIN}.id); always `42220` for Celina today. */
+    chainId: typeof CHAIN.id;
+    from: `0x${string}`;
+}
+/**
+ * Prepared flow = ordered unsigned transactions ready to sign or submit as UserOps —
+ * not a runtime workflow engine. JSON-safe form returned by `prepare*` tools and chat APIs.
+ * Primary payload is `steps`. Consumers simulate each step (see `@andrewkimjoseph/celina-sdk/simulation`),
+ * then call `sendTransactionAsync` (wagmi), `walletClient.sendTransaction` (viem), or
+ * `createAAClient().sendPreparedFlow` for sponsored UserOps.
+ */
+export interface SerializedPreparedFlow extends Omit<PreparedFlow, "steps"> {
+    steps: PreparedTx[];
+    preparedFlow: true;
+}
+/**
+ * Marks an ordered prepared-transaction list as JSON-safe for API and chat tool responses.
+ * @param flow - In-memory prepared transactions (`PreparedFlow`) to serialize
+ */
+export declare function serializePreparedFlow(flow: PreparedFlow): SerializedPreparedFlow;

package/build/src/types/prepared.js

@@ -0,0 +1,15 @@
+/**
+ * Marks an ordered prepared-transaction list as JSON-safe for API and chat tool responses.
+ * @param flow - In-memory prepared transactions (`PreparedFlow`) to serialize
+ */
+export function serializePreparedFlow(flow) {
+    return {
+        ...flow,
+        preparedFlow: true,
+        steps: flow.steps.map((step) => ({
+            ...step,
+            value: step.value?.toString(),
+        })),
+    };
+}
+//# sourceMappingURL=prepared.js.map

package/build/src/types/prepared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared.js","sourceRoot":"","sources":["../../../src/types/prepared.ts"],"names":[],"mappings":"AA2CA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACtD,OAAO;QACL,GAAG,IAAI;QACP,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE;SAC9B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/build/src/utils/celo-format.d.ts

@@ -0,0 +1,6 @@
+/** Human-readable CELO amount from wei (18 decimals). */
+export declare function formatCeloAmount(wei: bigint): string;
+/** Shorten a hex address for display (`0x1234…abcd`). */
+export declare function formatAddress(address: string): string;
+/** Format validator score basis points as a percentage string. */
+export declare function formatScorePercentage(score: bigint | number): string;

package/build/src/utils/celo-format.js

@@ -0,0 +1,17 @@
+import { formatUnits } from "viem";
+/** Human-readable CELO amount from wei (18 decimals). */
+export function formatCeloAmount(wei) {
+    return `${formatUnits(wei, 18)} CELO`;
+}
+/** Shorten a hex address for display (`0x1234…abcd`). */
+export function formatAddress(address) {
+    if (address.length < 10)
+        return address;
+    return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+/** Format validator score basis points as a percentage string. */
+export function formatScorePercentage(score) {
+    const value = typeof score === "bigint" ? Number(score) : score;
+    return `${(value / 100).toFixed(2)}%`;
+}
+//# sourceMappingURL=celo-format.js.map

package/build/src/utils/celo-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celo-format.js","sourceRoot":"","sources":["../../../src/utils/celo-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEnC,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC;AACxC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACxC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,qBAAqB,CAAC,KAAsB;IAC1D,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChE,OAAO,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC"}

package/build/src/utils/erc20-allowance-storage.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ERC-20 allowance storage slot helpers for gas simulation with state overrides.
+ * Used when estimating swap/send gas before on-chain approval is confirmed.
+ */
+import { type Address, type Hex, type StateOverride } from "viem";
+/** Common base slots for ERC-20 allowance mappings (Mento stablecoins use 7). */
+declare const ALLOWANCE_MAPPING_SLOTS: readonly [7n, 1n, 0n, 2n, 3n, 4n, 5n, 6n, 8n, 9n, 10n, 11n, 12n, 13n, 14n, 15n, 16n, 17n, 18n, 19n, 20n, 51n];
+/**
+ * Compute the storage slot for `allowance(owner, spender)` given the mapping base slot.
+ */
+export declare function erc20AllowanceStorageSlot(owner: Address, spender: Address, mappingSlot: bigint): Hex;
+/**
+ * viem `stateOverride` that sets ERC-20 allowance for gas estimation.
+ * @param mappingSlot - Allowance mapping slot in the token contract (try `ALLOWANCE_MAPPING_SLOTS`)
+ */
+export declare function erc20AllowanceStateOverride(token: Address, owner: Address, spender: Address, amount: bigint, mappingSlot: bigint): StateOverride;
+/** True when an estimateGas error likely means allowance/transfer would revert. */
+export declare function isLikelyTransferFailed(error: unknown): boolean;
+/** Mapping base slots to probe when simulating ERC-20 allowance (exported for tests). */
+export { ALLOWANCE_MAPPING_SLOTS };

package/build/src/utils/erc20-allowance-storage.js

@@ -0,0 +1,64 @@
+/**
+ * ERC-20 allowance storage slot helpers for gas simulation with state overrides.
+ * Used when estimating swap/send gas before on-chain approval is confirmed.
+ */
+import { encodeAbiParameters, keccak256, pad, parseAbiParameters, toHex, } from "viem";
+/** Common base slots for ERC-20 allowance mappings (Mento stablecoins use 7). */
+const ALLOWANCE_MAPPING_SLOTS = [
+    7n,
+    1n,
+    0n,
+    2n,
+    3n,
+    4n,
+    5n,
+    6n,
+    8n,
+    9n,
+    10n,
+    11n,
+    12n,
+    13n,
+    14n,
+    15n,
+    16n,
+    17n,
+    18n,
+    19n,
+    20n,
+    51n,
+];
+/**
+ * Compute the storage slot for `allowance(owner, spender)` given the mapping base slot.
+ */
+export function erc20AllowanceStorageSlot(owner, spender, mappingSlot) {
+    const ownerSlot = keccak256(encodeAbiParameters(parseAbiParameters("address, uint256"), [owner, mappingSlot]));
+    return keccak256(encodeAbiParameters(parseAbiParameters("address, bytes32"), [spender, ownerSlot]));
+}
+/**
+ * viem `stateOverride` that sets ERC-20 allowance for gas estimation.
+ * @param mappingSlot - Allowance mapping slot in the token contract (try `ALLOWANCE_MAPPING_SLOTS`)
+ */
+export function erc20AllowanceStateOverride(token, owner, spender, amount, mappingSlot) {
+    return [
+        {
+            address: token,
+            stateDiff: [
+                {
+                    slot: erc20AllowanceStorageSlot(owner, spender, mappingSlot),
+                    value: pad(toHex(amount)),
+                },
+            ],
+        },
+    ];
+}
+/** True when an estimateGas error likely means allowance/transfer would revert. */
+export function isLikelyTransferFailed(error) {
+    const message = error instanceof Error
+        ? `${error.message} ${error.cause instanceof Error ? error.cause.message : ""}`
+        : String(error);
+    return /transfer failed/i.test(message);
+}
+/** Mapping base slots to probe when simulating ERC-20 allowance (exported for tests). */
+export { ALLOWANCE_MAPPING_SLOTS };
+//# sourceMappingURL=erc20-allowance-storage.js.map

package/build/src/utils/erc20-allowance-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20-allowance-storage.js","sourceRoot":"","sources":["../../../src/utils/erc20-allowance-storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,GAAG,EACH,kBAAkB,EAClB,KAAK,GAIN,MAAM,MAAM,CAAC;AAEd,iFAAiF;AACjF,MAAM,uBAAuB,GAAG;IAC9B,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;CACK,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,OAAgB,EAChB,WAAmB;IAEnB,MAAM,SAAS,GAAG,SAAS,CACzB,mBAAmB,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAClF,CAAC;IACF,OAAO,SAAS,CACd,mBAAmB,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAClF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,KAAc,EACd,OAAgB,EAChB,MAAc,EACd,WAAmB;IAEnB,OAAO;QACL;YACE,OAAO,EAAE,KAAK;YACd,SAAS,EAAE;gBACT;oBACE,IAAI,EAAE,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC;oBAC5D,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;iBAC1B;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,OAAO,GACX,KAAK,YAAY,KAAK;QACpB,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/E,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,yFAAyF;AACzF,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/build/src/utils/format-date.d.ts

@@ -0,0 +1,2 @@
+/** Format a Unix timestamp (seconds) as a UTC long date string. */
+export declare function formatUnixDate(unixSeconds: number | bigint): string;

package/build/src/utils/format-date.js

@@ -0,0 +1,13 @@
+/** Format a Unix timestamp (seconds) as a UTC long date string. */
+export function formatUnixDate(unixSeconds) {
+    const date = new Date(Number(unixSeconds) * 1000);
+    return new Intl.DateTimeFormat("en-US", {
+        month: "long",
+        day: "numeric",
+        year: "numeric",
+        timeZone: "UTC",
+    })
+        .format(date)
+        .replace(",", "");
+}
+//# sourceMappingURL=format-date.js.map

package/build/src/utils/format-date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-date.js","sourceRoot":"","sources":["../../../src/utils/format-date.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,WAA4B;IACzD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QACtC,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,KAAK;KAChB,CAAC;SACC,MAAM,CAAC,IAAI,CAAC;SACZ,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC"}

package/build/src/utils/format-duration.d.ts

@@ -0,0 +1,2 @@
+/** Format a duration in seconds as a short human-readable string (hours and minutes). */
+export declare function formatDuration(seconds: bigint | number): string;

package/build/src/utils/format-duration.js

@@ -0,0 +1,17 @@
+/** Format a duration in seconds as a short human-readable string (hours and minutes). */
+export function formatDuration(seconds) {
+    const total = Number(seconds);
+    if (total <= 0)
+        return "0 minutes";
+    const hours = Math.floor(total / 3600);
+    const minutes = Math.floor((total % 3600) / 60);
+    const parts = [];
+    if (hours > 0) {
+        parts.push(`${hours} hour${hours === 1 ? "" : "s"}`);
+    }
+    if (minutes > 0 || hours === 0) {
+        parts.push(`${minutes} minute${minutes === 1 ? "" : "s"}`);
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=format-duration.js.map

package/build/src/utils/format-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-duration.js","sourceRoot":"","sources":["../../../src/utils/format-duration.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC;IAEnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/build/src/utils/format-unix-datetime.d.ts

@@ -0,0 +1,4 @@
+/** Format a Unix timestamp (seconds) as an ISO 8601 UTC string. */
+export declare function formatUnixIso(unixSeconds: number | bigint): string;
+/** Format a Unix timestamp for display in reason strings (UTC date and time). */
+export declare function formatUnixDateTimeUtc(unixSeconds: number | bigint): string;

package/build/src/utils/format-unix-datetime.js

@@ -0,0 +1,18 @@
+/** Format a Unix timestamp (seconds) as an ISO 8601 UTC string. */
+export function formatUnixIso(unixSeconds) {
+    return new Date(Number(unixSeconds) * 1000).toISOString();
+}
+/** Format a Unix timestamp for display in reason strings (UTC date and time). */
+export function formatUnixDateTimeUtc(unixSeconds) {
+    const date = new Date(Number(unixSeconds) * 1000);
+    return new Intl.DateTimeFormat("en-US", {
+        month: "long",
+        day: "numeric",
+        year: "numeric",
+        hour: "numeric",
+        minute: "2-digit",
+        timeZone: "UTC",
+        timeZoneName: "short",
+    }).format(date);
+}
+//# sourceMappingURL=format-unix-datetime.js.map

package/build/src/utils/format-unix-datetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-unix-datetime.js","sourceRoot":"","sources":["../../../src/utils/format-unix-datetime.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAC,WAA4B;IACxD,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5D,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,qBAAqB,CAAC,WAA4B;IAChE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QACtC,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,OAAO;KACtB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC"}

package/build/src/utils/gooddollar-ubi-period.d.ts

@@ -0,0 +1,23 @@
+/** Inputs for UBISchemeV2 period/cooldown eligibility (mirrors on-chain claim()). */
+export type UbiPeriodEligibilityInput = {
+    contractDay: bigint;
+    computedDay: bigint;
+    claimedForOnChainDay: boolean;
+    hasRoot: boolean;
+    schemePaused: boolean;
+    schemeStarted: boolean;
+    isWhitelisted: boolean;
+    claimable: bigint;
+};
+export type UbiPeriodEligibilityState = {
+    awaitingContractDayRoll: boolean;
+    alreadyClaimedToday: boolean;
+    inClaimCooldown: boolean;
+    isEligibleToClaim: boolean;
+};
+/**
+ * Resolve UBI claim eligibility from period day and on-chain hasClaimed.
+ * Between UTC noon and the first claim that calls setDay(), computedDay exceeds
+ * contractDay while hasClaimed still reflects the previous on-chain day.
+ */
+export declare function resolveUbiPeriodEligibility(input: UbiPeriodEligibilityInput): UbiPeriodEligibilityState;

package/build/src/utils/gooddollar-ubi-period.js

@@ -0,0 +1,23 @@
+/**
+ * Resolve UBI claim eligibility from period day and on-chain hasClaimed.
+ * Between UTC noon and the first claim that calls setDay(), computedDay exceeds
+ * contractDay while hasClaimed still reflects the previous on-chain day.
+ */
+export function resolveUbiPeriodEligibility(input) {
+    const awaitingContractDayRoll = input.computedDay > input.contractDay;
+    const alreadyClaimedToday = input.claimedForOnChainDay && !awaitingContractDayRoll;
+    const inClaimCooldown = input.hasRoot && alreadyClaimedToday;
+    const isEligibleToClaim = input.hasRoot &&
+        !input.schemePaused &&
+        input.schemeStarted &&
+        input.isWhitelisted &&
+        !inClaimCooldown &&
+        (input.claimable > 0n || awaitingContractDayRoll);
+    return {
+        awaitingContractDayRoll,
+        alreadyClaimedToday,
+        inClaimCooldown,
+        isEligibleToClaim,
+    };
+}
+//# sourceMappingURL=gooddollar-ubi-period.js.map

package/build/src/utils/gooddollar-ubi-period.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gooddollar-ubi-period.js","sourceRoot":"","sources":["../../../src/utils/gooddollar-ubi-period.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAgC;IAEhC,MAAM,uBAAuB,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtE,MAAM,mBAAmB,GACvB,KAAK,CAAC,oBAAoB,IAAI,CAAC,uBAAuB,CAAC;IACzD,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,IAAI,mBAAmB,CAAC;IAC7D,MAAM,iBAAiB,GACrB,KAAK,CAAC,OAAO;QACb,CAAC,KAAK,CAAC,YAAY;QACnB,KAAK,CAAC,aAAa;QACnB,KAAK,CAAC,aAAa;QACnB,CAAC,eAAe;QAChB,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,IAAI,uBAAuB,CAAC,CAAC;IAEpD,OAAO;QACL,uBAAuB;QACvB,mBAAmB;QACnB,eAAe;QACf,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/build/src/utils/normalize-address.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Normalize a hex address to EIP-55 checksum form.
+ * @param address - Hex address string
+ * @param label - Used in error messages when invalid (default `"address"`)
+ * @throws When the string is not a valid hex address
+ */
+export declare function normalizeAddress(address: string, label?: string): `0x${string}`;

package/build/src/utils/normalize-address.js

@@ -0,0 +1,16 @@
+import { getAddress } from "viem";
+/**
+ * Normalize a hex address to EIP-55 checksum form.
+ * @param address - Hex address string
+ * @param label - Used in error messages when invalid (default `"address"`)
+ * @throws When the string is not a valid hex address
+ */
+export function normalizeAddress(address, label = "address") {
+    try {
+        return getAddress(address);
+    }
+    catch {
+        throw new Error(`Invalid ${label}: ${address}`);
+    }
+}
+//# sourceMappingURL=normalize-address.js.map

package/build/src/utils/normalize-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-address.js","sourceRoot":"","sources":["../../../src/utils/normalize-address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,KAAK,GAAG,SAAS;IAEjB,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/build/src/utils/self-format.d.ts

@@ -0,0 +1,28 @@
+export interface SelfSessionLinksInput {
+    sessionToken: string;
+    deepLink: string;
+    scanUrl?: string;
+    apiBase?: string;
+}
+export interface SelfSessionLinks {
+    qr_code_url: string;
+    deep_link: string;
+}
+export declare function resolveSelfSessionLinks(input: SelfSessionLinksInput): SelfSessionLinks;
+export declare function formatSelfSessionLinksDisplay(links: SelfSessionLinks): string;
+export interface SelfCredentialLike {
+    nationality?: string;
+    olderThan?: bigint | number;
+    ofac?: boolean[];
+}
+export declare function formatCredentialsSummary(credentials?: SelfCredentialLike | null): string;
+export declare function truncateBody(body: string, maxBytes?: number): {
+    body: string;
+    truncated: boolean;
+};
+export declare function formatAgentInfo(info: Record<string, unknown>): Record<string, unknown>;
+export declare function proofExpiryFields(proofExpiresAtRaw: bigint): {
+    proof_expires_at: string | null;
+    days_until_expiry: number;
+    is_expiring_soon: boolean;
+};