@ape.swap/bonds-sdk 5.1.48 → 5.1.49-test.1

package/dist/types/aptosBonds.d.ts

@@ -0,0 +1,152 @@
+/**
+ * BondTerms — mirror of `apebond::bond::BondTerms`.
+ * `control_variable` is the BCV scaled by `bond::PERCENTAGE_BASE` (1e6).
+ * `vesting_term` and timestamps are in seconds.
+ */
+export interface AptosBondTerms {
+    control_variable: string;
+    vesting_term: string;
+    minimum_price: string;
+    max_payout: string;
+    max_debt: string;
+    max_total_payout: string;
+    initial_debt: string;
+}
+/**
+ * AptosBondMarket — subset of `apebond::bond::BondMarket` that we actually
+ * read from the SDK. `extend_ref`, `operators`, `redeemer_approved` and the
+ * full `bills` map are intentionally omitted to keep the TS shape lean.
+ */
+export interface AptosBondMarket {
+    payout_token: {
+        inner: string;
+    };
+    principal_token: {
+        inner: string;
+    };
+    treasury: {
+        inner: string;
+    };
+    fee_in_principal_recipient: string;
+    fee_in_payout_recipient: string;
+    terms: AptosBondTerms;
+    fee_in_principal: string;
+    fee_in_payout: string;
+    total_principal_billed: string;
+    total_payout_given: string;
+    payout_token_initial_supply: string;
+    total_debt: string;
+    last_decay: string;
+    last_bcv_update_timestamp: string;
+    min_bcv_update_interval: string;
+    paused: boolean;
+    emergency_paused: boolean;
+    name: string;
+}
+/**
+ * Derived pricing view — the values that the `bond_pricing` view function
+ * returns in a single shot. Kept as a separate interface because some
+ * consumers only care about pricing and we do not want to force them to read
+ * the whole market resource.
+ */
+export interface AptosBondPricing {
+    bond_price: string;
+    true_bond_price: string;
+    debt_ratio: string;
+    debt_decay: string;
+    current_debt: string;
+}
+/**
+ * Bill — mirror of `apebond::bond::Bill`. One per user position.
+ */
+export interface AptosBill {
+    payout: string;
+    payout_claimed: string;
+    vesting_term: string;
+    vesting_start_timestamp: string;
+    last_claim_timestamp: string;
+    true_price_paid: string;
+}
+/**
+ * Arguments forwarded to `apebond::bond::deposit`. Numeric values are always
+ * stringified BigInts to keep compatibility with the Aptos TS SDK which
+ * serialises BCS arguments from strings.
+ */
+export interface AptosDepositPayload {
+    market: string;
+    amount: string;
+    max_price: string;
+    depositor: string;
+}
+/**
+ * Arguments forwarded to `apebond::bond::claim(market, bill_id: u64)`.
+ */
+export interface AptosClaimPayload {
+    market: string;
+    bill_id: string;
+}
+/**
+ * Tuple shape returned by `apebond::bond::market_info(market)` — 27 elements.
+ *
+ * Reference: apebond-move-playground/app/bond-market-info/page.tsx reads
+ * every index individually and labels it the same way.
+ *
+ * All `u64` / `u128` fields come back as strings to preserve precision.
+ * `true_bill_price` (index 17) is scaled by `PRICE_DECIMALS = 1e8`.
+ */
+export type AptosMarketInfoTuple = readonly [
+    name: string,
+    owner: string,
+    paused: boolean,
+    emergencyPaused: boolean,
+    totalPrincipalBilled: string,
+    totalPayoutGiven: string,
+    currentDebt: string,
+    treasury: string,
+    treasuryOwner: string,
+    treasuryPayoutAddress: string,
+    payoutToken: string,
+    principalToken: string,
+    billNftCollection: string,
+    feeInPrincipal: string,
+    feeInPayout: string,
+    feeInPrincipalRecipient: string,
+    feeInPayoutRecipient: string,
+    trueBillPrice: string,
+    controlVariable: string,
+    vestingTerm: string,
+    minimumPrice: string,
+    maxPayout: string,
+    maxDebt: string,
+    maxTotalPayout: string,
+    vestingType: string,
+    cliffPeriod: string,
+    currentTimestamp: string
+];
+/**
+ * Tuple shape returned by `apebond::bond_nft::vesting_progress(bill_id)`.
+ * `[total_vested, claimable]` — both u64, both scaled by the payout token's
+ * decimals.
+ */
+export type AptosVestingProgressTuple = readonly [totalVested: string, claimable: string];
+/**
+ * Result of `apebond::bond::bill_info(market, bill_addr)`. The playground
+ * documents the fields as:
+ *   "Bill struct contains: payout, payout_claimed, vesting_term,
+ *    last_timestamp, true_price_paid"
+ * We also include `vesting_start_timestamp` which exists in the underlying
+ * Move struct (`apebond-move/sources/bond.move::Bill`).
+ *
+ * TODO(APTOS): verify the exact field names against the deployed
+ * contract. The playground serialises the struct via `JSON.stringify(bill[0])`
+ * so the Move field names are preserved verbatim.
+ */
+export interface AptosBillInfo {
+    payout: string;
+    payout_claimed: string;
+    vesting_term: string;
+    vesting_start_timestamp?: string;
+    last_claim_timestamp?: string;
+    last_timestamp?: string;
+    true_price_paid: string;
+}

package/dist/types/yourbonds.d.ts

@@ -57,9 +57,7 @@ export interface UserBillNftData {
             address: string;
             name: string;
             symbol: string;
-            decimals: {
-                [chainId: number]: number;
-            };
+            decimals: Partial<Record<ChainId, number | null>>;
         };
         payoutTokenPrice: string;
         principalToken: string;
@@ -67,17 +65,13 @@ export interface UserBillNftData {
             address: string;
             symbol: string;
             name: string;
-            decimals: {
-                [chainId: number]: number;
-            };
+            decimals: Partial<Record<ChainId, number | null>>;
         };
         token1: {
             address: string;
             symbol: string;
             name: string;
-            decimals: {
-                [chainId: number]: number;
-            };
+            decimals: Partial<Record<ChainId, number | null>>;
         };
         type: string;
         vestingPeriodSeconds: number;

package/dist/utils/aptosHelpers.d.ts

@@ -0,0 +1,80 @@
+import { Aptos } from '@aptos-labs/ts-sdk';
+import type { AptosBillInfo, AptosClaimPayload, AptosDepositPayload, AptosMarketInfoTuple, AptosVestingProgressTuple } from '../types/aptosBonds';
+export declare const getAptosClient: () => Aptos;
+export declare const safeExtractAddress: (input: unknown) => string | undefined;
+export declare const toAtomicUnits: (amount: string | number, decimals: number) => string;
+export declare const buildDepositPayload: (args: AptosDepositPayload) => {
+    function: `${string}::${string}::${string}`;
+    typeArguments: string[];
+    functionArguments: (string | number)[];
+};
+export declare const buildClaimPayload: (args: AptosClaimPayload) => {
+    function: `${string}::${string}::${string}`;
+    typeArguments: string[];
+    functionArguments: (string | number)[];
+};
+interface AptosTxnWithEvents {
+    events?: Array<{
+        type: string;
+        data: Record<string, unknown>;
+    }>;
+}
+export declare const extractEventData: <T = Record<string, unknown>>(txn: AptosTxnWithEvents, eventSuffix: string) => T | undefined;
+/**
+ * `bond::DepositEvent` — emitted by the deposit entry function.
+ * Contains bill_id, bill_address, deposit_amount, payout_amount, price.
+ */
+export declare const extractDepositEvent: (txn: AptosTxnWithEvents) => {
+    bill_id: string;
+    bill_address: string;
+    market: string;
+    deposit_amount: string;
+    payout_amount: string;
+    price: string;
+    depositor: string;
+    recipient: string;
+} | undefined;
+/**
+ * Extract bill_id from transaction events. Checks both `BillMinted` (from bond_nft)
+ * and `DepositEvent` (from bond) since the contract emits both.
+ */
+export declare const extractBillMinted: (txn: AptosTxnWithEvents) => {
+    bill_id: string;
+    owner: string;
+} | undefined;
+export declare const aptosIndexerFetch: <T = unknown>(url: string, query: string, variables?: Record<string, unknown>) => Promise<T>;
+/**
+ * `bond::market_info(market)` — returns the 27-element market info tuple.
+ */
+export declare const readAptosMarketInfo: (marketAddress: string) => Promise<AptosMarketInfoTuple>;
+/**
+ * `bond::bill_info(market, bill_id)` — returns the Bill struct for a
+ * specific bill. The contract takes `bill_id: u64` (NOT the object address).
+ * Uses REST directly to avoid SDK remoteAbi serialisation bug with u64 args.
+ */
+export declare const readAptosBillInfo: (marketAddress: string, billId: string) => Promise<AptosBillInfo>;
+/**
+ * `bond_nft::user_bills(user)` — returns all bill_ids owned by the user
+ * across every deployed market. The view returns `[bill_ids]` (the inner
+ * array is at index 0), so we unwrap it here.
+ */
+export declare const readUserBillIds: (user: string) => Promise<string[]>;
+/**
+ * `bond::vesting_progress(market, bill_id)` — returns `[vested_amount, claimable_amount]`.
+ * Note: this is in `bond` module (not `bond_nft`), and takes the market as first argument.
+ * Uses REST directly to avoid SDK remoteAbi serialisation bug with u64 args.
+ */
+export declare const readVestingProgress: (marketAddress: string, billId: string) => Promise<AptosVestingProgressTuple>;
+/**
+ * `bond_nft::bond_market_by_id(bill_id)` — which market owns this bill.
+ * Uses REST directly — SDK's aptos.view() mis-serialises u64→address functions.
+ */
+export declare const readBondMarketByBillId: (billId: string) => Promise<string>;
+/**
+ * `bond_nft::nft_address(bill_id)` — resolve the scalar bill_id to the
+ * on-chain NFT object address (aka `bill_addr`). Needed to then call
+ * `bond::bill_info(market, bill_addr)` or `bond::claim(market, bill_addr)`.
+ * Uses REST directly — SDK's aptos.view() mis-serialises u64→address functions.
+ */
+export declare const readNftAddressByBillId: (billId: string) => Promise<string>;
+export {};

package/dist/utils/aptosHelpers.js

@@ -0,0 +1,202 @@
+import { AptosConfig, Aptos } from '@aptos-labs/ts-sdk';
+import 'bignumber.js';
+import { APTOS_VIEW_USER_BILLS, APTOS_NETWORK, APTOS_FULLNODE_URL, APTOS_VIEW_BOND_MARKET_BY_ID, APTOS_VIEW_NFT_ADDRESS, APTOS_VIEW_BILL_INFO, APTOS_VIEW_VESTING_PROGRESS, getRandomAptosApiKey, APTOS_VIEW_MARKET_INFO } from '../constants/aptosConstants.js';
+
+// ---------------------------------------------------------------------------
+// Aptos client — lazy singleton
+// ---------------------------------------------------------------------------
+// We keep one client per (network, api key) pair. The API key is picked with
+// `getRandomAptosApiKey()` on first call, so different sessions hit a
+// different key (very simple load balancing). If the pool is empty we fall
+// back to unauthenticated requests.
+let _aptosClient;
+const getAptosClient = () => {
+    if (_aptosClient)
+        return _aptosClient;
+    const apiKey = getRandomAptosApiKey();
+    // The Aptos ts-sdk exposes `API_KEY` directly on `clientConfig`; it adds
+    // the `Authorization: Bearer <key>` header internally. This is the
+    // idiomatic way to authenticate — no manual header wiring needed.
+    const config = new AptosConfig({
+        network: APTOS_NETWORK,
+        ...(apiKey && { clientConfig: { API_KEY: apiKey } }),
+    });
+    _aptosClient = new Aptos(config);
+    return _aptosClient;
+};
+// ---------------------------------------------------------------------------
+// Address normalisation
+// ---------------------------------------------------------------------------
+// Aptos wallet adapters can surface account addresses in several shapes:
+// plain string, `{ data: Uint8Array }`, `Uint8Array`, or an `AccountAddress`
+// instance. This helper returns a canonical `0x`-prefixed hex string, or
+// `undefined` if the input cannot be decoded. We keep the interface loose so
+// callers can pass whatever the SDK hands them.
+const safeExtractAddress = (input) => {
+    if (input == null)
+        return undefined;
+    // Already a string
+    if (typeof input === 'string') {
+        return input.startsWith('0x') ? input : `0x${input}`;
+    }
+    // AccountAddress instance (has `toString()` that returns `0x...`)
+    if (typeof input === 'object' && typeof input.toString === 'function') {
+        const asObject = input;
+        // Prefer `.data` if it looks like a byte array — `.toString()` on
+        // AccountAddress already returns the canonical hex, but some wallets
+        // return `{ data: Uint8Array }` without the method.
+        if (asObject.data instanceof Uint8Array) {
+            return bytesToHex(asObject.data);
+        }
+        if (Array.isArray(asObject.data)) {
+            return bytesToHex(new Uint8Array(asObject.data));
+        }
+        const stringified = asObject.toString();
+        if (stringified.startsWith('0x'))
+            return stringified;
+    }
+    // Raw Uint8Array
+    if (input instanceof Uint8Array) {
+        return bytesToHex(input);
+    }
+    // Raw number[]
+    if (Array.isArray(input)) {
+        return bytesToHex(new Uint8Array(input));
+    }
+    return undefined;
+};
+const bytesToHex = (bytes) => {
+    let out = '0x';
+    for (let i = 0; i < bytes.length; i++) {
+        out += bytes[i].toString(16).padStart(2, '0');
+    }
+    return out;
+};
+const extractEventData = (txn, eventSuffix) => {
+    const event = txn?.events?.find((e) => e.type.includes(eventSuffix));
+    return event?.data;
+};
+/**
+ * `bond::DepositEvent` — emitted by the deposit entry function.
+ * Contains bill_id, bill_address, deposit_amount, payout_amount, price.
+ */
+const extractDepositEvent = (txn) => extractEventData(txn, '::DepositEvent');
+/**
+ * Extract bill_id from transaction events. Checks both `BillMinted` (from bond_nft)
+ * and `DepositEvent` (from bond) since the contract emits both.
+ */
+const extractBillMinted = (txn) => {
+    // Try BillMinted event first (emitted by bond_nft module)
+    const billMinted = extractEventData(txn, '::BillMinted');
+    if (billMinted)
+        return billMinted;
+    // Fall back to DepositEvent (emitted by bond module)
+    const deposit = extractDepositEvent(txn);
+    if (!deposit)
+        return undefined;
+    return { bill_id: deposit.bill_id, owner: deposit.depositor };
+};
+// ---------------------------------------------------------------------------
+// View function readers (PLAN_001 Etapa 5b — real read skeleton)
+// ---------------------------------------------------------------------------
+// Thin wrappers around `aptos.view(...)` for the specific view functions the
+// SDK needs. Every reader throws on RPC / contract error — callers should
+// wrap in try/catch so a missing deployment degrades gracefully rather than
+// crashing the UI.
+//
+// Shapes are verified against apebond-move-playground pages. See the matching
+// `AptosMarketInfoTuple` / `AptosBillInfo` / `AptosVestingProgressTuple`
+// types for documentation on each field.
+/**
+ * `bond::market_info(market)` — returns the 27-element market info tuple.
+ */
+const readAptosMarketInfo = async (marketAddress) => {
+    const aptos = getAptosClient();
+    const result = await aptos.view({
+        payload: {
+            function: APTOS_VIEW_MARKET_INFO,
+            functionArguments: [marketAddress],
+        },
+    });
+    return result;
+};
+/**
+ * `bond::bill_info(market, bill_id)` — returns the Bill struct for a
+ * specific bill. The contract takes `bill_id: u64` (NOT the object address).
+ * Uses REST directly to avoid SDK remoteAbi serialisation bug with u64 args.
+ */
+const readAptosBillInfo = async (marketAddress, billId) => {
+    const result = await viewViaRest(APTOS_VIEW_BILL_INFO, [marketAddress, billId]);
+    return result[0];
+};
+/**
+ * `bond_nft::user_bills(user)` — returns all bill_ids owned by the user
+ * across every deployed market. The view returns `[bill_ids]` (the inner
+ * array is at index 0), so we unwrap it here.
+ */
+const readUserBillIds = async (user) => {
+    const aptos = getAptosClient();
+    const result = await aptos.view({
+        payload: {
+            function: APTOS_VIEW_USER_BILLS,
+            functionArguments: [user],
+        },
+    });
+    const ids = (result[0] ?? []);
+    return ids.map((id) => String(id));
+};
+/**
+ * `bond::vesting_progress(market, bill_id)` — returns `[vested_amount, claimable_amount]`.
+ * Note: this is in `bond` module (not `bond_nft`), and takes the market as first argument.
+ * Uses REST directly to avoid SDK remoteAbi serialisation bug with u64 args.
+ */
+const readVestingProgress = async (marketAddress, billId) => {
+    const result = await viewViaRest(APTOS_VIEW_VESTING_PROGRESS, [marketAddress, billId]);
+    return [String(result[0] ?? '0'), String(result[1] ?? '0')];
+};
+// ---------------------------------------------------------------------------
+// REST-based view call — bypasses the SDK's remoteAbi serialisation which
+// has a bug in v6.x where u64 arguments to functions returning `address` get
+// mis-serialised. The REST endpoint handles string arguments natively.
+// ---------------------------------------------------------------------------
+const viewViaRest = async (fn, args, typeArgs = []) => {
+    const apiKey = getRandomAptosApiKey();
+    const res = await fetch(`${APTOS_FULLNODE_URL}/view`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(apiKey && { Authorization: `Bearer ${apiKey}` }),
+        },
+        body: JSON.stringify({
+            function: fn,
+            type_arguments: typeArgs,
+            arguments: args,
+        }),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`View call ${fn} failed: ${res.status} ${text}`);
+    }
+    return (await res.json());
+};
+/**
+ * `bond_nft::bond_market_by_id(bill_id)` — which market owns this bill.
+ * Uses REST directly — SDK's aptos.view() mis-serialises u64→address functions.
+ */
+const readBondMarketByBillId = async (billId) => {
+    const result = await viewViaRest(APTOS_VIEW_BOND_MARKET_BY_ID, [billId]);
+    return String(result[0] ?? '');
+};
+/**
+ * `bond_nft::nft_address(bill_id)` — resolve the scalar bill_id to the
+ * on-chain NFT object address (aka `bill_addr`). Needed to then call
+ * `bond::bill_info(market, bill_addr)` or `bond::claim(market, bill_addr)`.
+ * Uses REST directly — SDK's aptos.view() mis-serialises u64→address functions.
+ */
+const readNftAddressByBillId = async (billId) => {
+    const result = await viewViaRest(APTOS_VIEW_NFT_ADDRESS, [billId]);
+    return String(result[0] ?? '');
+};
+
+export { extractBillMinted, extractDepositEvent, extractEventData, getAptosClient, readAptosBillInfo, readAptosMarketInfo, readBondMarketByBillId, readNftAddressByBillId, readUserBillIds, readVestingProgress, safeExtractAddress };
+//# sourceMappingURL=aptosHelpers.js.map

package/dist/utils/aptosHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aptosHelpers.js","sources":["../../src/utils/aptosHelpers.ts"],"sourcesContent":["import { Aptos, AptosConfig } from '@aptos-labs/ts-sdk'\nimport BigNumber from 'bignumber.js'\nimport {\n  APTOS_CLAIM_FUNCTION,\n  APTOS_DEPOSIT_FUNCTION,\n  APTOS_FULLNODE_URL,\n  APTOS_NETWORK,\n  APTOS_VIEW_BILL_INFO,\n  APTOS_VIEW_BOND_MARKET_BY_ID,\n  APTOS_VIEW_MARKET_INFO,\n  APTOS_VIEW_NFT_ADDRESS,\n  APTOS_VIEW_USER_BILLS,\n  APTOS_VIEW_VESTING_PROGRESS,\n  getRandomAptosApiKey,\n} from '../constants/aptosConstants'\nimport type {\n  AptosBillInfo,\n  AptosClaimPayload,\n  AptosDepositPayload,\n  AptosMarketInfoTuple,\n  AptosVestingProgressTuple,\n} from '../types/aptosBonds'\n\n// ---------------------------------------------------------------------------\n// Aptos client — lazy singleton\n// ---------------------------------------------------------------------------\n// We keep one client per (network, api key) pair. The API key is picked with\n// `getRandomAptosApiKey()` on first call, so different sessions hit a\n// different key (very simple load balancing). If the pool is empty we fall\n// back to unauthenticated requests.\nlet _aptosClient: Aptos | undefined\n\nexport const getAptosClient = (): Aptos => {\n  if (_aptosClient) return _aptosClient\n  const apiKey = getRandomAptosApiKey()\n  // The Aptos ts-sdk exposes `API_KEY` directly on `clientConfig`; it adds\n  // the `Authorization: Bearer <key>` header internally. This is the\n  // idiomatic way to authenticate — no manual header wiring needed.\n  const config = new AptosConfig({\n    network: APTOS_NETWORK,\n    ...(apiKey && { clientConfig: { API_KEY: apiKey } }),\n  })\n  _aptosClient = new Aptos(config)\n  return _aptosClient\n}\n\n// ---------------------------------------------------------------------------\n// Address normalisation\n// ---------------------------------------------------------------------------\n// Aptos wallet adapters can surface account addresses in several shapes:\n// plain string, `{ data: Uint8Array }`, `Uint8Array`, or an `AccountAddress`\n// instance. This helper returns a canonical `0x`-prefixed hex string, or\n// `undefined` if the input cannot be decoded. We keep the interface loose so\n// callers can pass whatever the SDK hands them.\nexport const safeExtractAddress = (input: unknown): string | undefined => {\n  if (input == null) return undefined\n\n  // Already a string\n  if (typeof input === 'string') {\n    return input.startsWith('0x') ? input : `0x${input}`\n  }\n\n  // AccountAddress instance (has `toString()` that returns `0x...`)\n  if (typeof input === 'object' && typeof (input as { toString?: () => string }).toString === 'function') {\n    const asObject = input as { data?: Uint8Array | number[]; toString: () => string }\n    // Prefer `.data` if it looks like a byte array — `.toString()` on\n    // AccountAddress already returns the canonical hex, but some wallets\n    // return `{ data: Uint8Array }` without the method.\n    if (asObject.data instanceof Uint8Array) {\n      return bytesToHex(asObject.data)\n    }\n    if (Array.isArray(asObject.data)) {\n      return bytesToHex(new Uint8Array(asObject.data))\n    }\n    const stringified = asObject.toString()\n    if (stringified.startsWith('0x')) return stringified\n  }\n\n  // Raw Uint8Array\n  if (input instanceof Uint8Array) {\n    return bytesToHex(input)\n  }\n\n  // Raw number[]\n  if (Array.isArray(input)) {\n    return bytesToHex(new Uint8Array(input))\n  }\n\n  return undefined\n}\n\nconst bytesToHex = (bytes: Uint8Array): string => {\n  let out = '0x'\n  for (let i = 0; i < bytes.length; i++) {\n    out += bytes[i].toString(16).padStart(2, '0')\n  }\n  return out\n}\n\n// ---------------------------------------------------------------------------\n// Unit conversion\n// ---------------------------------------------------------------------------\n// User inputs live in \"whole tokens\" (e.g. \"1.5 USDC\"). The Aptos ts-sdk\n// serialises numeric function arguments from strings, so we convert to\n// atomic units and return a stringified BigInt.\nexport const toAtomicUnits = (amount: string | number, decimals: number): string => {\n  if (amount === '' || amount == null) return '0'\n  const bn = new BigNumber(amount).times(new BigNumber(10).pow(decimals))\n  // Floor so we never over-spend what the user typed.\n  return bn.integerValue(BigNumber.ROUND_FLOOR).toFixed(0)\n}\n\n// ---------------------------------------------------------------------------\n// Payload builders\n// ---------------------------------------------------------------------------\n// These return the `InputEntryFunctionData` shape consumed by\n// `wallet.signAndSubmitTransaction({ sender, data: ... })`. Keeping them in\n// one place means the buy/claim components do not have to repeat the\n// function-name and argument order.\n\nexport const buildDepositPayload = (args: AptosDepositPayload) => ({\n  function: APTOS_DEPOSIT_FUNCTION,\n  typeArguments: [] as string[],\n  functionArguments: [args.market, args.amount, args.max_price, args.depositor] as (string | number)[],\n})\n\nexport const buildClaimPayload = (args: AptosClaimPayload) => ({\n  function: APTOS_CLAIM_FUNCTION,\n  typeArguments: [] as string[],\n  // `apebond::bond::claim(market, bill_id: u64)` — the contract takes the\n  // scalar bill_id, NOT the object address.\n  functionArguments: [args.market, args.bill_id] as (string | number)[],\n})\n\n// ---------------------------------------------------------------------------\n// Event extractors\n// ---------------------------------------------------------------------------\n// Parse events out of a `waitForTransaction` response. The event `type`\n// format is `${module}::${EventStruct}`. We match by `.endsWith('::Foo')` so\n// we do not have to hard-code the full module path (which contains the\n// contract address).\n\ninterface AptosTxnWithEvents {\n  events?: Array<{ type: string; data: Record<string, unknown> }>\n}\n\nexport const extractEventData = <T = Record<string, unknown>>(\n  txn: AptosTxnWithEvents,\n  eventSuffix: string,\n): T | undefined => {\n  const event = txn?.events?.find((e) => e.type.includes(eventSuffix))\n  return event?.data as T | undefined\n}\n\n/**\n * `bond::DepositEvent` — emitted by the deposit entry function.\n * Contains bill_id, bill_address, deposit_amount, payout_amount, price.\n */\nexport const extractDepositEvent = (\n  txn: AptosTxnWithEvents,\n): { bill_id: string; bill_address: string; market: string; deposit_amount: string; payout_amount: string; price: string; depositor: string; recipient: string } | undefined =>\n  extractEventData(txn, '::DepositEvent')\n\n/**\n * Extract bill_id from transaction events. Checks both `BillMinted` (from bond_nft)\n * and `DepositEvent` (from bond) since the contract emits both.\n */\nexport const extractBillMinted = (txn: AptosTxnWithEvents): { bill_id: string; owner: string } | undefined => {\n  // Try BillMinted event first (emitted by bond_nft module)\n  const billMinted = extractEventData<{ bill_id: string; owner: string }>(txn, '::BillMinted')\n  if (billMinted) return billMinted\n  // Fall back to DepositEvent (emitted by bond module)\n  const deposit = extractDepositEvent(txn)\n  if (!deposit) return undefined\n  return { bill_id: deposit.bill_id, owner: deposit.depositor }\n}\n\n// ---------------------------------------------------------------------------\n// Fetch helper — GraphQL to the Aptos indexer\n// ---------------------------------------------------------------------------\n// Uses the same API key that is configured on the Aptos client. Everything\n// else on the HTTP layer goes through the Aptos ts-sdk, but the indexer\n// needs a raw `fetch` call because GraphQL is not part of the SDK surface.\nexport const aptosIndexerFetch = async <T = unknown>(\n  url: string,\n  query: string,\n  variables?: Record<string, unknown>,\n): Promise<T> => {\n  const apiKey = getRandomAptosApiKey()\n  const response = await fetch(url, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      ...(apiKey && { Authorization: `Bearer ${apiKey}` }),\n    },\n    body: JSON.stringify({ query, variables }),\n  })\n  if (!response.ok) {\n    throw new Error(`Aptos indexer request failed: ${response.status}`)\n  }\n  const json = (await response.json()) as { data: T; errors?: Array<{ message: string }> }\n  if (json.errors?.length) {\n    throw new Error(`Aptos indexer returned errors: ${json.errors.map((e) => e.message).join(', ')}`)\n  }\n  return json.data\n}\n\n// ---------------------------------------------------------------------------\n// View function readers (PLAN_001 Etapa 5b — real read skeleton)\n// ---------------------------------------------------------------------------\n// Thin wrappers around `aptos.view(...)` for the specific view functions the\n// SDK needs. Every reader throws on RPC / contract error — callers should\n// wrap in try/catch so a missing deployment degrades gracefully rather than\n// crashing the UI.\n//\n// Shapes are verified against apebond-move-playground pages. See the matching\n// `AptosMarketInfoTuple` / `AptosBillInfo` / `AptosVestingProgressTuple`\n// types for documentation on each field.\n\n/**\n * `bond::market_info(market)` — returns the 27-element market info tuple.\n */\nexport const readAptosMarketInfo = async (marketAddress: string): Promise<AptosMarketInfoTuple> => {\n  const aptos = getAptosClient()\n  const result = await aptos.view({\n    payload: {\n      function: APTOS_VIEW_MARKET_INFO,\n      functionArguments: [marketAddress],\n    },\n  })\n  return result as unknown as AptosMarketInfoTuple\n}\n\n/**\n * `bond::bill_info(market, bill_id)` — returns the Bill struct for a\n * specific bill. The contract takes `bill_id: u64` (NOT the object address).\n * Uses REST directly to avoid SDK remoteAbi serialisation bug with u64 args.\n */\nexport const readAptosBillInfo = async (\n  marketAddress: string,\n  billId: string,\n): Promise<AptosBillInfo> => {\n  const result = await viewViaRest(APTOS_VIEW_BILL_INFO, [marketAddress, billId])\n  return result[0] as unknown as AptosBillInfo\n}\n\n/**\n * `bond_nft::user_bills(user)` — returns all bill_ids owned by the user\n * across every deployed market. The view returns `[bill_ids]` (the inner\n * array is at index 0), so we unwrap it here.\n */\nexport const readUserBillIds = async (user: string): Promise<string[]> => {\n  const aptos = getAptosClient()\n  const result = await aptos.view({\n    payload: {\n      function: APTOS_VIEW_USER_BILLS,\n      functionArguments: [user],\n    },\n  })\n  const ids = (result[0] ?? []) as unknown as Array<string | number>\n  return ids.map((id) => String(id))\n}\n\n/**\n * `bond::vesting_progress(market, bill_id)` — returns `[vested_amount, claimable_amount]`.\n * Note: this is in `bond` module (not `bond_nft`), and takes the market as first argument.\n * Uses REST directly to avoid SDK remoteAbi serialisation bug with u64 args.\n */\nexport const readVestingProgress = async (marketAddress: string, billId: string): Promise<AptosVestingProgressTuple> => {\n  const result = await viewViaRest(APTOS_VIEW_VESTING_PROGRESS, [marketAddress, billId])\n  return [String(result[0] ?? '0'), String(result[1] ?? '0')] as const\n}\n\n// ---------------------------------------------------------------------------\n// REST-based view call — bypasses the SDK's remoteAbi serialisation which\n// has a bug in v6.x where u64 arguments to functions returning `address` get\n// mis-serialised. The REST endpoint handles string arguments natively.\n// ---------------------------------------------------------------------------\nconst viewViaRest = async (\n  fn: string,\n  args: string[],\n  typeArgs: string[] = [],\n): Promise<unknown[]> => {\n  const apiKey = getRandomAptosApiKey()\n  const res = await fetch(`${APTOS_FULLNODE_URL}/view`, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      ...(apiKey && { Authorization: `Bearer ${apiKey}` }),\n    },\n    body: JSON.stringify({\n      function: fn,\n      type_arguments: typeArgs,\n      arguments: args,\n    }),\n  })\n  if (!res.ok) {\n    const text = await res.text()\n    throw new Error(`View call ${fn} failed: ${res.status} ${text}`)\n  }\n  return (await res.json()) as unknown[]\n}\n\n/**\n * `bond_nft::bond_market_by_id(bill_id)` — which market owns this bill.\n * Uses REST directly — SDK's aptos.view() mis-serialises u64→address functions.\n */\nexport const readBondMarketByBillId = async (billId: string): Promise<string> => {\n  const result = await viewViaRest(APTOS_VIEW_BOND_MARKET_BY_ID, [billId])\n  return String(result[0] ?? '')\n}\n\n/**\n * `bond_nft::nft_address(bill_id)` — resolve the scalar bill_id to the\n * on-chain NFT object address (aka `bill_addr`). Needed to then call\n * `bond::bill_info(market, bill_addr)` or `bond::claim(market, bill_addr)`.\n * Uses REST directly — SDK's aptos.view() mis-serialises u64→address functions.\n */\nexport const readNftAddressByBillId = async (billId: string): Promise<string> => {\n  const result = await viewViaRest(APTOS_VIEW_NFT_ADDRESS, [billId])\n  return String(result[0] ?? '')\n}\n"],"names":[],"mappings":"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"}

package/dist/utils/getNativeTicker.js

@@ -1,3 +1,4 @@
+import '../config/constants/tokens.js';
 import { WNATIVE } from '@ape.swap/apeswap-lists';
 
 const getNativeTicker = (chain) => {

package/dist/utils/getNativeTicker.js.map

@@ -1 +1 @@
-{"version":3,"file":"getNativeTicker.js","sources":["../../src/utils/getNativeTicker.ts"],"sourcesContent":["import { ChainId, Token } from '@ape.swap/apeswap-lists'\nimport { WNATIVE } from '../config/constants/tokens'\n\nconst getNativeTicker = (chain?: ChainId) => {\n  if (!chain) return undefined\n  return WNATIVE[chain]?.symbol.substring(1)\n}\n\nconst getTokenSymbol = (token: Token) => {\n  const nativeSymbols = ['BNB', 'ETH', 'POL', 'IOTA']\n  return nativeSymbols.includes(token?.symbol) ? `w${token?.symbol}` : token?.symbol\n}\n\nexport const getSymbol = (token?: Token | 'NATIVE', chainId?: ChainId) => {\n  if (!token) return ''\n  return token === 'NATIVE' ? getNativeTicker(chainId) : getTokenSymbol(token)\n}\n"],"names":[],"mappings":";;AAGA,MAAM,eAAe,GAAG,CAAC,KAAe,KAAI;AAC1C,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,SAAS;IAC5B,OAAO,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,KAAY,KAAI;IACtC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC;IACnD,OAAO,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,KAAK,EAAE,MAAM,CAAA,CAAE,GAAG,KAAK,EAAE,MAAM;AACpF,CAAC;MAEY,SAAS,GAAG,CAAC,KAAwB,EAAE,OAAiB,KAAI;AACvE,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,EAAE;AACrB,IAAA,OAAO,KAAK,KAAK,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC;AAC9E;;;;"}
+{"version":3,"file":"getNativeTicker.js","sources":["../../src/utils/getNativeTicker.ts"],"sourcesContent":["import { ChainId, Token } from '@ape.swap/apeswap-lists'\nimport { WNATIVE } from '../config/constants/tokens'\n\nconst getNativeTicker = (chain?: ChainId) => {\n  if (!chain) return undefined\n  return WNATIVE[chain]?.symbol.substring(1)\n}\n\nconst getTokenSymbol = (token: Token) => {\n  const nativeSymbols = ['BNB', 'ETH', 'POL', 'IOTA']\n  return nativeSymbols.includes(token?.symbol) ? `w${token?.symbol}` : token?.symbol\n}\n\nexport const getSymbol = (token?: Token | 'NATIVE', chainId?: ChainId) => {\n  if (!token) return ''\n  return token === 'NATIVE' ? getNativeTicker(chainId) : getTokenSymbol(token)\n}\n"],"names":[],"mappings":";;;AAGA,MAAM,eAAe,GAAG,CAAC,KAAe,KAAI;AAC1C,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,SAAS;IAC5B,OAAO,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,KAAY,KAAI;IACtC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC;IACnD,OAAO,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,KAAK,EAAE,MAAM,CAAA,CAAE,GAAG,KAAK,EAAE,MAAM;AACpF,CAAC;MAEY,SAAS,GAAG,CAAC,KAAwB,EAAE,OAAiB,KAAI;AACvE,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,EAAE;AACrB,IAAA,OAAO,KAAK,KAAK,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC;AAC9E;;;;"}

package/dist/utils/suiHelpers.d.ts

@@ -0,0 +1,6 @@
+import { SuiClient } from '@mysten/sui/client';
+export declare const getSuiClient: () => SuiClient;
+export declare const toAtomicUnits: (amount: string | number, decimals: number) => string;
+export declare const fromAtomicUnits: (amount: string | number, decimals: number) => number;
+export declare const readFreshTrueBondPrice: (marketObjectId: string) => Promise<bigint>;
+export declare const verifySuiTxSuccess: (digest: string) => Promise<void>;

package/dist/utils/suiHelpers.js

@@ -0,0 +1,106 @@
+import { SuiClient } from '@mysten/sui/client';
+import BigNumber from 'bignumber.js';
+import { SUI_FULLNODE_URL } from '../constants/suiConstants.js';
+
+// ---------------------------------------------------------------------------
+// Sui client — lazy singleton
+// ---------------------------------------------------------------------------
+let _suiClient;
+const getSuiClient = () => {
+    if (_suiClient)
+        return _suiClient;
+    _suiClient = new SuiClient({ url: SUI_FULLNODE_URL });
+    return _suiClient;
+};
+// ---------------------------------------------------------------------------
+// Unit conversion
+// ---------------------------------------------------------------------------
+// User inputs live in "whole tokens" (e.g. "1.5 SUI"). The Sui SDK
+// serialises numeric function arguments from strings, so we convert to
+// atomic units and return a stringified BigInt.
+const toAtomicUnits = (amount, decimals) => {
+    if (amount === '' || amount == null)
+        return '0';
+    const bn = new BigNumber(amount).times(new BigNumber(10).pow(decimals));
+    // Floor so we never over-spend what the user typed.
+    return bn.integerValue(BigNumber.ROUND_FLOOR).toFixed(0);
+};
+// Atomic → human-readable.
+const fromAtomicUnits = (amount, decimals) => {
+    if (amount === '' || amount == null)
+        return 0;
+    return new BigNumber(amount).div(new BigNumber(10).pow(decimals)).toNumber();
+};
+// ---------------------------------------------------------------------------
+// Fresh bond price reader — reads the BondMarket object on-chain and
+// computes the current true_price using the same bond_math formulas as
+// the Move contract. Returns the u64 value (scaled 1e8).
+// ---------------------------------------------------------------------------
+const PRICE_DECIMALS = 100000000n; // 1e8
+const PERCENTAGE_BASE = 1000000n; // 1e6
+const pow10bi = (n) => 10n ** BigInt(n);
+const valueOfToken = (fromDec, toDec, amount) => {
+    if (toDec >= fromDec)
+        return amount * pow10bi(toDec - fromDec);
+    return amount / pow10bi(fromDec - toDec);
+};
+const readFreshTrueBondPrice = async (marketObjectId) => {
+    const client = getSuiClient();
+    const obj = await client.getObject({ id: marketObjectId, options: { showContent: true } });
+    if (!obj.data?.content || obj.data.content.dataType !== 'moveObject') {
+        throw new Error(`[Sui] Could not read BondMarket ${marketObjectId}`);
+    }
+    const f = obj.data.content.fields;
+    const terms = f.terms?.fields ??
+        f.terms;
+    const totalDebt = BigInt(String(f.total_debt ?? '0'));
+    const payoutInitialSupply = BigInt(String(f.payout_token_initial_supply ?? '0'));
+    const controlVariable = BigInt(String(terms.control_variable ?? '0'));
+    const minimumPrice = BigInt(String(terms.minimum_price ?? '0'));
+    const vestingTerm = BigInt(String(terms.vesting_term ?? '1'));
+    const lastDecay = BigInt(String(f.last_decay ?? '0'));
+    const feeInPrincipal = BigInt(String(f.fee_in_principal ?? '0'));
+    const payoutDecimals = Number(f.payout_decimals ?? 9);
+    const principalDecimals = Number(f.principal_decimals ?? 9);
+    // Decay debt client-side (same as contract's decay_debt)
+    const nowSeconds = BigInt(Math.floor(Date.now() / 1000));
+    let currentDebt = totalDebt;
+    if (nowSeconds > lastDecay && vestingTerm > 0n) {
+        const elapsed = nowSeconds - lastDecay;
+        const decay = (totalDebt * elapsed) / vestingTerm;
+        currentDebt = totalDebt > decay ? totalDebt - decay : 0n;
+    }
+    // calculate_price — contract casts total_debt (u128) to u64 via `as u64`
+    const currentDebtU64 = currentDebt & 0xffffffffffffffffn;
+    const currentDebtPayout = valueOfToken(principalDecimals, payoutDecimals, currentDebtU64);
+    const payoutScale = pow10bi(payoutDecimals);
+    const principalScale = pow10bi(principalDecimals);
+    const debtRatio = payoutInitialSupply > 0n
+        ? (currentDebtPayout * payoutScale) / payoutInitialSupply
+        : 0n;
+    const basePrice = (controlVariable * debtRatio * principalScale) / PRICE_DECIMALS;
+    const price = basePrice < minimumPrice ? minimumPrice : basePrice;
+    // calculate_true_price (includes fee)
+    const denominator = PERCENTAGE_BASE - feeInPrincipal;
+    const truePrice = denominator > 0n ? (price * PERCENTAGE_BASE) / denominator : price;
+    return truePrice;
+};
+// ---------------------------------------------------------------------------
+// TX status verification — Sui returns digests for failed TXs too.
+// Call this after waitForTransaction to ensure the TX actually succeeded.
+// ---------------------------------------------------------------------------
+const verifySuiTxSuccess = async (digest) => {
+    const client = getSuiClient();
+    const txBlock = await client.getTransactionBlock({
+        digest,
+        options: { showEffects: true },
+    });
+    const status = txBlock.effects?.status;
+    if (status?.status !== 'success') {
+        const errorMsg = status?.error ?? 'Transaction failed on-chain';
+        throw new Error(`Transaction failed: ${errorMsg}`);
+    }
+};
+
+export { fromAtomicUnits, getSuiClient, readFreshTrueBondPrice, toAtomicUnits, verifySuiTxSuccess };
+//# sourceMappingURL=suiHelpers.js.map

package/dist/utils/suiHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suiHelpers.js","sources":["../../src/utils/suiHelpers.ts"],"sourcesContent":["import { SuiClient } from '@mysten/sui/client'\nimport BigNumber from 'bignumber.js'\nimport { SUI_FULLNODE_URL } from '../constants/suiConstants'\n\n// ---------------------------------------------------------------------------\n// Sui client — lazy singleton\n// ---------------------------------------------------------------------------\nlet _suiClient: SuiClient | undefined\n\nexport const getSuiClient = (): SuiClient => {\n  if (_suiClient) return _suiClient\n  _suiClient = new SuiClient({ url: SUI_FULLNODE_URL })\n  return _suiClient\n}\n\n// ---------------------------------------------------------------------------\n// Unit conversion\n// ---------------------------------------------------------------------------\n// User inputs live in \"whole tokens\" (e.g. \"1.5 SUI\"). The Sui SDK\n// serialises numeric function arguments from strings, so we convert to\n// atomic units and return a stringified BigInt.\nexport const toAtomicUnits = (amount: string | number, decimals: number): string => {\n  if (amount === '' || amount == null) return '0'\n  const bn = new BigNumber(amount).times(new BigNumber(10).pow(decimals))\n  // Floor so we never over-spend what the user typed.\n  return bn.integerValue(BigNumber.ROUND_FLOOR).toFixed(0)\n}\n\n// Atomic → human-readable.\nexport const fromAtomicUnits = (amount: string | number, decimals: number): number => {\n  if (amount === '' || amount == null) return 0\n  return new BigNumber(amount).div(new BigNumber(10).pow(decimals)).toNumber()\n}\n\n// ---------------------------------------------------------------------------\n// Fresh bond price reader — reads the BondMarket object on-chain and\n// computes the current true_price using the same bond_math formulas as\n// the Move contract. Returns the u64 value (scaled 1e8).\n// ---------------------------------------------------------------------------\n\nconst PRICE_DECIMALS = 100_000_000n // 1e8\nconst PERCENTAGE_BASE = 1_000_000n // 1e6\n\nconst pow10bi = (n: number): bigint => 10n ** BigInt(n)\n\nconst valueOfToken = (fromDec: number, toDec: number, amount: bigint): bigint => {\n  if (toDec >= fromDec) return amount * pow10bi(toDec - fromDec)\n  return amount / pow10bi(fromDec - toDec)\n}\n\nexport const readFreshTrueBondPrice = async (marketObjectId: string): Promise<bigint> => {\n  const client = getSuiClient()\n  const obj = await client.getObject({ id: marketObjectId, options: { showContent: true } })\n\n  if (!obj.data?.content || obj.data.content.dataType !== 'moveObject') {\n    throw new Error(`[Sui] Could not read BondMarket ${marketObjectId}`)\n  }\n\n  const f = obj.data.content.fields as Record<string, unknown>\n  const terms = (f.terms as Record<string, unknown>)?.fields as Record<string, unknown> ??\n    f.terms as Record<string, unknown>\n\n  const totalDebt = BigInt(String(f.total_debt ?? '0'))\n  const payoutInitialSupply = BigInt(String(f.payout_token_initial_supply ?? '0'))\n  const controlVariable = BigInt(String(terms.control_variable ?? '0'))\n  const minimumPrice = BigInt(String(terms.minimum_price ?? '0'))\n  const vestingTerm = BigInt(String(terms.vesting_term ?? '1'))\n  const lastDecay = BigInt(String(f.last_decay ?? '0'))\n  const feeInPrincipal = BigInt(String(f.fee_in_principal ?? '0'))\n  const payoutDecimals = Number(f.payout_decimals ?? 9)\n  const principalDecimals = Number(f.principal_decimals ?? 9)\n\n  // Decay debt client-side (same as contract's decay_debt)\n  const nowSeconds = BigInt(Math.floor(Date.now() / 1000))\n  let currentDebt = totalDebt\n  if (nowSeconds > lastDecay && vestingTerm > 0n) {\n    const elapsed = nowSeconds - lastDecay\n    const decay = (totalDebt * elapsed) / vestingTerm\n    currentDebt = totalDebt > decay ? totalDebt - decay : 0n\n  }\n\n  // calculate_price — contract casts total_debt (u128) to u64 via `as u64`\n  const currentDebtU64 = currentDebt & 0xFFFFFFFFFFFFFFFFn\n  const currentDebtPayout = valueOfToken(principalDecimals, payoutDecimals, currentDebtU64)\n  const payoutScale = pow10bi(payoutDecimals)\n  const principalScale = pow10bi(principalDecimals)\n\n  const debtRatio = payoutInitialSupply > 0n\n    ? (currentDebtPayout * payoutScale) / payoutInitialSupply\n    : 0n\n  const basePrice = (controlVariable * debtRatio * principalScale) / PRICE_DECIMALS\n\n  const price = basePrice < minimumPrice ? minimumPrice : basePrice\n\n  // calculate_true_price (includes fee)\n  const denominator = PERCENTAGE_BASE - feeInPrincipal\n  const truePrice = denominator > 0n ? (price * PERCENTAGE_BASE) / denominator : price\n\n  return truePrice\n}\n\n// ---------------------------------------------------------------------------\n// TX status verification — Sui returns digests for failed TXs too.\n// Call this after waitForTransaction to ensure the TX actually succeeded.\n// ---------------------------------------------------------------------------\n\nexport const verifySuiTxSuccess = async (digest: string): Promise<void> => {\n  const client = getSuiClient()\n  const txBlock = await client.getTransactionBlock({\n    digest,\n    options: { showEffects: true },\n  })\n  const status = txBlock.effects?.status\n  if (status?.status !== 'success') {\n    const errorMsg = status?.error ?? 'Transaction failed on-chain'\n    throw new Error(`Transaction failed: ${errorMsg}`)\n  }\n}\n"],"names":[],"mappings":"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"}