@continuumdao/continuum-node-sdk 1.3.1 → 1.3.3

package/dist/core/mpc/mpa-fee-status.js

@@ -0,0 +1,431 @@
+import { createPublicClient, defineChain, formatUnits, getAddress, http, } from 'viem';
+import { buildManagementQueryPath, managementGet } from '../../api/management-api.js';
+import { KEY_GEN_ADDRESS_KIND_ETHEREUM, MPA_WALLET_CONTRACT_CONFIG, MPA_WALLET_READ_ABI, } from '../../config/mpa-wallet.js';
+import { fetchGlobalNonceByKeyGenId } from '../keygen.js';
+import { computeVpnHostBinding } from '../vpn/vpn-host-binding.js';
+import { mpcAuthEnvelopeData } from './sign-request-utils.js';
+import { canPayKeyGenMonthFromCredit, canPayVpnMonthFromCredit, keyGenPayMonthDisabledReason, vpnPayMonthDisabledReason, } from './mpa-billing-helpers.js';
+const ERC20_SYMBOL_DECIMALS_ABI = [
+    {
+        inputs: [],
+        name: 'symbol',
+        outputs: [{ name: '', type: 'string', internalType: 'string' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'decimals',
+        outputs: [{ name: '', type: 'uint8', internalType: 'uint8' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+function getMpaPublicClient() {
+    const chain = defineChain({
+        id: MPA_WALLET_CONTRACT_CONFIG.chainId,
+        name: 'Linea Mainnet',
+        nativeCurrency: { decimals: 18, name: 'Ether', symbol: 'ETH' },
+        rpcUrls: { default: { http: [MPA_WALLET_CONTRACT_CONFIG.rpcUrl] } },
+    });
+    return createPublicClient({
+        chain,
+        transport: http(MPA_WALLET_CONTRACT_CONFIG.rpcUrl),
+    });
+}
+function billingAddressFromEth(eth) {
+    return getAddress(eth.startsWith('0x') ? eth : `0x${eth}`);
+}
+function unwrapRecord(raw) {
+    const data = mpcAuthEnvelopeData(raw) ?? raw;
+    if (data != null && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    return null;
+}
+function parseOptionalBool(raw) {
+    if (typeof raw === 'boolean')
+        return raw;
+    if (raw === 'true' || raw === '1' || raw === 1)
+        return true;
+    if (raw === 'false' || raw === '0' || raw === 0)
+        return false;
+    return undefined;
+}
+function parseBillingMonthUtc(raw) {
+    if (typeof raw === 'number' && raw > 0)
+        return raw;
+    if (typeof raw === 'string' && raw.trim()) {
+        const n = Number(raw);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    return undefined;
+}
+function feeStatusToMpaWalletStatus(fee, globalNonce) {
+    const decimals = fee.feetokendecimals ?? 18;
+    const symbol = fee.feetokensymbol ?? 'TOKEN';
+    const depositWei = BigInt(fee.remainingdepositwei || '0');
+    const monthlyWei = BigInt(fee.currentmonthlyfeewei || '0');
+    const topUp = BigInt(fee.requireminimumtopupwei || '0');
+    const freeLeft = fee.freetransactionsleft;
+    const funded = topUp === 0n && fee.registered && (fee.remainingnonces > 0 || depositWei >= monthlyWei);
+    return {
+        registered: fee.registered,
+        globalNonce: fee.globalnonce ?? globalNonce ?? undefined,
+        remainingNonces: fee.remainingnonces,
+        freeTransactionsLeft: freeLeft,
+        remainingDepositWei: fee.remainingdepositwei,
+        remainingDeposit: formatUnits(depositWei, decimals),
+        feeTokenSymbol: symbol,
+        feeTokenDecimals: decimals,
+        requiredMinimumTopUpWei: fee.requireminimumtopupwei,
+        monthlyFeeWei: fee.currentmonthlyfeewei,
+        monthlyFee: formatUnits(monthlyWei, decimals),
+        overageFeePerSigWei: fee.currentoveragefeepernoncewei,
+        purchasedOverageSignatures: fee.purchasedoveragesignatures,
+        activeFreeSignaturesPerMonth: fee.activefreesignaturespermonth,
+        fundedForCurrentMonth: funded,
+        hasEverDeposited: depositWei > 0n,
+    };
+}
+function parseFeeStatusPayload(data) {
+    const rn = data.remainingnonces ?? data.RemainingNonces;
+    if (typeof rn !== 'number')
+        return null;
+    const gn = data.globalnonce ?? data.GlobalNonce;
+    return {
+        globalnonce: typeof gn === 'number' ? gn : undefined,
+        remainingnonces: rn,
+        remainingdepositwei: String(data.remainingdepositwei ?? data.RemainingDepositWei ?? '0'),
+        requireminimumtopupwei: String(data.requireminimumtopupwei ?? data.RequireMinimumTopUpWei ?? '0'),
+        currentmonthlyfeewei: String(data.currentmonthlyfeewei ?? data.CurrentMonthlyFeeWei ?? '0'),
+        currentoveragefeepernoncewei: String(data.currentoveragefeepernoncewei ?? data.CurrentOverageFeePerNonceWei ?? '0'),
+        activefreesignaturespermonth: typeof data.activefreesignaturespermonth === 'number'
+            ? data.activefreesignaturespermonth
+            : undefined,
+        activevpnmonthlyfeewei: typeof data.activevpnmonthlyfeewei === 'string' ? data.activevpnmonthlyfeewei : undefined,
+        purchasedoveragesignatures: typeof data.purchasedoveragesignatures === 'number'
+            ? data.purchasedoveragesignatures
+            : undefined,
+        feetokensymbol: typeof data.feetokensymbol === 'string' ? data.feetokensymbol : undefined,
+        feetokendecimals: typeof data.feetokendecimals === 'number' ? data.feetokendecimals : undefined,
+        freetransactionsleft: typeof data.freetransactionsleft === 'number' ? data.freetransactionsleft : undefined,
+        registered: Boolean(data.registered ?? data.Registered),
+    };
+}
+export async function fetchFeeStatusByKeyGenId(config, keyGenId) {
+    const path = buildManagementQueryPath('/getFeeStatusByKeyGenId', { id: keyGenId });
+    const raw = await managementGet(config, path);
+    if (!raw.ok)
+        return null;
+    const data = unwrapRecord(raw.data);
+    if (!data)
+        return null;
+    return parseFeeStatusPayload(data);
+}
+async function resolveKeyGenGlobalNonceForChain(config, keyGenAddress, keyGenId, nodeGlobalNonce, feeStatusGlobalNonce) {
+    if (nodeGlobalNonce != null)
+        return nodeGlobalNonce;
+    if (feeStatusGlobalNonce != null)
+        return feeStatusGlobalNonce;
+    const trimmed = keyGenAddress.trim();
+    if (!trimmed)
+        return 0;
+    try {
+        const client = getMpaPublicClient();
+        return await client.getTransactionCount({
+            address: billingAddressFromEth(trimmed),
+            blockTag: 'pending',
+        });
+    }
+    catch {
+        return 0;
+    }
+}
+async function fetchMpaWalletStatusFromChain(keyGenId, currentNonce) {
+    const client = getMpaPublicClient();
+    const contractAddress = MPA_WALLET_CONTRACT_CONFIG.contractAddress;
+    try {
+        const registered = await client.readContract({
+            address: contractAddress,
+            abi: MPA_WALLET_READ_ABI,
+            functionName: 'isKeyGenRegistered',
+            args: [keyGenId, KEY_GEN_ADDRESS_KIND_ETHEREUM],
+        });
+        if (!registered)
+            return { registered: false, globalNonce: currentNonce };
+        const sub = await client.readContract({
+            address: contractAddress,
+            abi: MPA_WALLET_READ_ABI,
+            functionName: 'getSubscriptionStatus',
+            args: [keyGenId, KEY_GEN_ADDRESS_KIND_ETHEREUM],
+        });
+        const [, , signatureCountAtMonthStart, keyGenCreditBalance, monthlyFee, freeSignaturesPerMonth, overageFee, fundedForCurrentMonth, purchasedOverage] = sub;
+        const [remainingNonces, requiredTopUp] = await Promise.all([
+            client.readContract({
+                address: contractAddress,
+                abi: MPA_WALLET_READ_ABI,
+                functionName: 'getRemainingNonces',
+                args: [keyGenId, KEY_GEN_ADDRESS_KIND_ETHEREUM, BigInt(currentNonce)],
+            }),
+            client.readContract({
+                address: contractAddress,
+                abi: MPA_WALLET_READ_ABI,
+                functionName: 'getRequiredMinimumTopUp',
+                args: [keyGenId, KEY_GEN_ADDRESS_KIND_ETHEREUM],
+            }),
+        ]);
+        const sigAtStart = Number(signatureCountAtMonthStart);
+        const freeLeft = fundedForCurrentMonth
+            ? Math.max(0, Number(freeSignaturesPerMonth) - Math.max(0, currentNonce - sigAtStart))
+            : 0;
+        const feeToken = await client.readContract({
+            address: contractAddress,
+            abi: MPA_WALLET_READ_ABI,
+            functionName: 'FEE_TOKEN',
+        });
+        let symbol = 'TOKEN';
+        let decimals = 18;
+        try {
+            const [sym, dec] = await Promise.all([
+                client.readContract({
+                    address: feeToken,
+                    abi: ERC20_SYMBOL_DECIMALS_ABI,
+                    functionName: 'symbol',
+                }),
+                client.readContract({
+                    address: feeToken,
+                    abi: ERC20_SYMBOL_DECIMALS_ABI,
+                    functionName: 'decimals',
+                }),
+            ]);
+            symbol = sym ?? symbol;
+            decimals = Number(dec ?? decimals);
+        }
+        catch {
+            // keep defaults
+        }
+        return {
+            registered: true,
+            globalNonce: currentNonce,
+            freeTransactionsLeft: freeLeft,
+            remainingNonces: Number(remainingNonces),
+            remainingDepositWei: keyGenCreditBalance.toString(),
+            remainingDeposit: formatUnits(keyGenCreditBalance, decimals),
+            requiredMinimumTopUpWei: requiredTopUp.toString(),
+            monthlyFeeWei: monthlyFee.toString(),
+            monthlyFee: formatUnits(monthlyFee, decimals),
+            overageFeePerSigWei: overageFee.toString(),
+            purchasedOverageSignatures: Number(purchasedOverage),
+            activeFreeSignaturesPerMonth: Number(freeSignaturesPerMonth),
+            fundedForCurrentMonth: Boolean(fundedForCurrentMonth),
+            feeTokenSymbol: symbol,
+            feeTokenDecimals: decimals,
+            hasEverDeposited: keyGenCreditBalance > 0n,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function enrichKeyGenWalletStatus(status) {
+    return {
+        ...status,
+        canPayMonthFromCredit: canPayKeyGenMonthFromCredit(status),
+        payMonthDisabledReason: keyGenPayMonthDisabledReason(status),
+    };
+}
+/** Node fee status with on-chain KeyGen subscription fallback. */
+export async function fetchMergedMpaWalletStatus(config, keyGenId, keyGenEthAddress) {
+    const [feeStatus, globalNonceResult] = await Promise.all([
+        fetchFeeStatusByKeyGenId(config, keyGenId),
+        fetchGlobalNonceByKeyGenId(config, keyGenId),
+    ]);
+    const nodeGlobalNonce = globalNonceResult.ok ? globalNonceResult.data : null;
+    const resolvedNonce = await resolveKeyGenGlobalNonceForChain(config, keyGenEthAddress, keyGenId, nodeGlobalNonce, feeStatus?.globalnonce);
+    if (feeStatus) {
+        const status = feeStatusToMpaWalletStatus(feeStatus, resolvedNonce);
+        status.globalNonce = nodeGlobalNonce ?? resolvedNonce;
+        if (!status.registered) {
+            const chainStatus = await fetchMpaWalletStatusFromChain(keyGenId, resolvedNonce);
+            if (chainStatus?.registered) {
+                chainStatus.globalNonce = nodeGlobalNonce ?? resolvedNonce;
+                return enrichKeyGenWalletStatus(chainStatus);
+            }
+            return enrichKeyGenWalletStatus(status);
+        }
+        const chain = await fetchMpaWalletStatusFromChain(keyGenId, resolvedNonce);
+        if (chain?.fundedForCurrentMonth != null) {
+            status.fundedForCurrentMonth = chain.fundedForCurrentMonth;
+        }
+        return enrichKeyGenWalletStatus(status);
+    }
+    const chainStatus = await fetchMpaWalletStatusFromChain(keyGenId, resolvedNonce);
+    if (chainStatus) {
+        chainStatus.globalNonce = nodeGlobalNonce ?? resolvedNonce;
+        return enrichKeyGenWalletStatus(chainStatus);
+    }
+    return enrichKeyGenWalletStatus({
+        registered: false,
+        error: 'Failed to load MPA wallet status',
+        globalNonce: nodeGlobalNonce ?? resolvedNonce,
+    });
+}
+function parseVpnFeeStatusPayload(data) {
+    const billingMonthActive = parseOptionalBool(data.fundedforcurrentmonth ??
+        data.FundedForCurrentMonth ??
+        data.vpnBillingMonthActive ??
+        data.VpnBillingMonthActive);
+    const accountRegistered = parseOptionalBool(data.vpnBillingRegistered ??
+        data.VpnBillingRegistered ??
+        data.accountRegistered ??
+        data.AccountRegistered);
+    const legacyRegistered = parseOptionalBool(data.registered ?? data.Registered);
+    const poolWei = BigInt(String(data.vpncreditbalancewei ?? data.VpnCreditBalanceWei ?? '0'));
+    const paidThrough = parseBillingMonthUtc(data.paidthroughmonth ?? data.PaidThroughMonth);
+    const hasPriorBilling = poolWei > 0n || paidThrough != null;
+    const monthInactive = billingMonthActive === false ||
+        (billingMonthActive == null && legacyRegistered === false && hasPriorBilling);
+    const registered = accountRegistered ??
+        (monthInactive && hasPriorBilling ? true : (legacyRegistered ?? false));
+    return {
+        registered,
+        paidthroughmonth: paidThrough,
+        fundedforcurrentmonth: billingMonthActive ?? legacyRegistered,
+        vpncreditbalancewei: poolWei.toString(),
+        vpnmonthlyfeewei: String(data.vpnmonthlyfeewei ?? data.VpnMonthlyFeeWei ?? '0'),
+        requireminimumtopupwei: String(data.requireminimumtopupwei ?? data.RequireMinimumTopUpWei ?? '0'),
+        feetokensymbol: typeof data.feetokensymbol === 'string' ? data.feetokensymbol : undefined,
+        feetokendecimals: typeof data.feetokendecimals === 'number' ? data.feetokendecimals : undefined,
+        hostip: typeof data.hostip === 'string' ? data.hostip : undefined,
+    };
+}
+export async function fetchVpnFeeStatusByNode(config, hostIp) {
+    const path = buildManagementQueryPath('/getVpnFeeStatus', {
+        hostIp: hostIp?.trim() || undefined,
+    });
+    const raw = await managementGet(config, path);
+    if (!raw.ok)
+        return null;
+    const data = unwrapRecord(raw.data);
+    if (!data)
+        return null;
+    return parseVpnFeeStatusPayload(data);
+}
+export async function fetchVpnSubscriptionStatus(nodeKey, hostIpAddress) {
+    try {
+        const hostBinding = computeVpnHostBinding(nodeKey, hostIpAddress);
+        const client = getMpaPublicClient();
+        const contractAddress = MPA_WALLET_CONTRACT_CONFIG.contractAddress;
+        const sub = await client.readContract({
+            address: contractAddress,
+            abi: MPA_WALLET_READ_ABI,
+            functionName: 'getVpnSubscriptionStatus',
+            args: [nodeKey, hostBinding],
+        });
+        const [registered, paidThroughMonth, vpnCreditBalance, vpnMonthlyFee, fundedForCurrentMonth] = sub;
+        return {
+            registered: Boolean(registered),
+            paidThroughMonth: Number(paidThroughMonth),
+            vpnCreditBalanceWei: vpnCreditBalance.toString(),
+            vpnMonthlyFeeWei: vpnMonthlyFee.toString(),
+            fundedForCurrentMonth: Boolean(fundedForCurrentMonth),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function vpnChainHasBillingAccount(chain) {
+    if (chain.registered)
+        return true;
+    if (chain.paidThroughMonth > 0)
+        return true;
+    return BigInt(chain.vpnCreditBalanceWei || '0') > 0n;
+}
+function mergeVpnFeeStatusWithChain(node, chain) {
+    if (!vpnChainHasBillingAccount(chain))
+        return node;
+    if (!node.registered) {
+        return {
+            ...node,
+            registered: true,
+            paidthroughmonth: chain.paidThroughMonth,
+            fundedforcurrentmonth: chain.fundedForCurrentMonth,
+            vpncreditbalancewei: chain.vpnCreditBalanceWei,
+            vpnmonthlyfeewei: chain.vpnMonthlyFeeWei || node.vpnmonthlyfeewei,
+        };
+    }
+    const nodePool = BigInt(node.vpncreditbalancewei || '0');
+    const chainPool = BigInt(chain.vpnCreditBalanceWei || '0');
+    return {
+        ...node,
+        paidthroughmonth: chain.paidThroughMonth ?? node.paidthroughmonth,
+        fundedforcurrentmonth: chain.fundedForCurrentMonth,
+        vpncreditbalancewei: (chainPool > nodePool ? chainPool : nodePool).toString(),
+        vpnmonthlyfeewei: chain.vpnMonthlyFeeWei || node.vpnmonthlyfeewei,
+    };
+}
+function vpnFeeStatusToMpaVpnStatus(fee, nodeKey, hostBinding) {
+    const decimals = fee.feetokendecimals ?? 6;
+    const symbol = fee.feetokensymbol ?? 'USDC';
+    const poolWei = BigInt(fee.vpncreditbalancewei || '0');
+    const monthlyWei = BigInt(fee.vpnmonthlyfeewei || '0');
+    const billingRegistered = fee.registered;
+    const monthActive = fee.fundedforcurrentmonth;
+    const status = {
+        registered: billingRegistered,
+        vpnBillingRegistered: billingRegistered,
+        nodeKey,
+        hostBinding,
+        fundedForCurrentMonth: monthActive,
+        vpnBillingMonthActive: monthActive,
+        paidThroughMonth: fee.paidthroughmonth,
+        vpnCreditBalanceWei: fee.vpncreditbalancewei,
+        vpnCreditBalance: formatUnits(poolWei, decimals),
+        vpnMonthlyFeeWei: fee.vpnmonthlyfeewei,
+        vpnMonthlyFee: formatUnits(monthlyWei, decimals),
+        requireMinimumTopUpWei: fee.requireminimumtopupwei,
+        feeTokenSymbol: symbol,
+        feeTokenDecimals: decimals,
+    };
+    return {
+        ...status,
+        canPayMonthFromCredit: canPayVpnMonthFromCredit(status),
+        payMonthDisabledReason: vpnPayMonthDisabledReason(status),
+    };
+}
+/** Node VPN fee status with on-chain subscription fallback. */
+export async function fetchMergedMpaVpnStatus(config, nodeKey, hostIpAddress) {
+    const trimmedKey = nodeKey.trim();
+    const trimmedHost = hostIpAddress.trim();
+    const hostBinding = computeVpnHostBinding(trimmedKey, trimmedHost);
+    const [nodeStatus, chainStatus] = await Promise.all([
+        fetchVpnFeeStatusByNode(config, trimmedHost),
+        trimmedKey && trimmedHost
+            ? fetchVpnSubscriptionStatus(trimmedKey, trimmedHost)
+            : Promise.resolve(null),
+    ]);
+    let merged = null;
+    if (nodeStatus && chainStatus) {
+        merged = mergeVpnFeeStatusWithChain(nodeStatus, chainStatus);
+    }
+    else if (nodeStatus) {
+        merged = nodeStatus;
+    }
+    else if (chainStatus && vpnChainHasBillingAccount(chainStatus)) {
+        merged = {
+            registered: true,
+            paidthroughmonth: chainStatus.paidThroughMonth,
+            fundedforcurrentmonth: chainStatus.fundedForCurrentMonth,
+            vpncreditbalancewei: chainStatus.vpnCreditBalanceWei,
+            vpnmonthlyfeewei: chainStatus.vpnMonthlyFeeWei,
+            requireminimumtopupwei: '0',
+        };
+    }
+    if (!merged)
+        return null;
+    return vpnFeeStatusToMpaVpnStatus(merged, trimmedKey, hostBinding);
+}
+//# sourceMappingURL=mpa-fee-status.js.map

package/dist/core/mpc/mpa-fee-status.js.map

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

package/dist/core/mpc/mpa-top-up.d.ts

@@ -1,17 +1,7 @@
 import type { NodeSdkConfig } from '../../config/schema.js';
 import type { SdkResult } from '../result.js';
-export declare function getMpaWalletStatus(config: NodeSdkConfig, input: unknown): Promise<SdkResult<{
-    registered: boolean;
-    freeTransactionsLeft?: number;
-    hasEverDeposited?: boolean;
-    remainingDeposit?: string;
-    feeTokenSymbol?: string;
-    remainingNonces?: number;
-    globalNonce?: number;
-    requiredMinimumTopUpWei?: string;
-    monthlyFee?: string;
-    error?: string;
-}>>;
+import { type MpaWalletStatusData } from './mpa-fee-status.js';
+export declare function getMpaWalletStatus(config: NodeSdkConfig, input: unknown): Promise<SdkResult<MpaWalletStatusData>>;
 export declare function createMpaTopUpMultiSignRequest(config: NodeSdkConfig, input: unknown): Promise<SdkResult<{
     requestId: string;
 }>>;

package/dist/core/mpc/mpa-top-up.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mpa-top-up.d.ts","sourceRoot":"","sources":["../../../src/core/mpc/mpa-top-up.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAQ1D,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAqC5C,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,OAAO,GACZ,OAAO,CACT,SAAS,CAAC;IACT,UAAU,EAAE,OAAO,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CACF,CA+GA;AAED,wBAAsB,8BAA8B,CACnD,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,CAAC,CAAC,CA2GzC"}
+{"version":3,"file":"mpa-top-up.d.ts","sourceRoot":"","sources":["../../../src/core/mpc/mpa-top-up.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAQ1D,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAM5C,OAAO,EAA6B,KAAK,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AAiCzF,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CA4BzC;AAcD,wBAAsB,8BAA8B,CACnD,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,CAAC,CAAC,CAoIzC"}

package/dist/core/mpc/mpa-top-up.js

@@ -5,6 +5,8 @@ import { fetchGlobalNonceByKeyGenId, fetchKeyGenResult } from '../keygen.js';
 import { buildMultiSignProposal } from '../../evm/proposal-builder.js';
 import { signAndSubmitMultiSignRequest } from './sign-request-body.js';
 import { assertExecutorNativeSufficientForProposal } from './gas-preflight.js';
+import { fetchMergedMpaWalletStatus } from './mpa-fee-status.js';
+import { shouldSyncKeyGenMonthAfterDeposit } from './mpa-billing-helpers.js';
 const ERC20_SYMBOL_DECIMALS_ABI = [
     {
         inputs: [],
@@ -48,81 +50,9 @@ export async function getMpaWalletStatus(config, input) {
     if (!eth) {
         return { ok: false, reason: 'KeyGen has no ethereum address.' };
     }
-    const globalNonceResult = await fetchGlobalNonceByKeyGenId(config, parsed.data.keyGenId);
-    const globalNonce = globalNonceResult.ok ? globalNonceResult.data : undefined;
-    const client = getMpaPublicClient();
-    const billingAddress = getAddress(eth.startsWith('0x') ? eth : `0x${eth}`);
-    const contractAddress = MPA_WALLET_CONTRACT_CONFIG.contractAddress;
-    const keyGenId = parsed.data.keyGenId;
     try {
-        const registered = await client.readContract({
-            address: contractAddress,
-            abi: MPA_WALLET_READ_ABI,
-            functionName: 'isKeyGenRegistered',
-            args: [keyGenId, KEY_GEN_ADDRESS_KIND_ETHEREUM],
-        });
-        if (!registered) {
-            return { ok: true, data: { registered: false, globalNonce } };
-        }
-        const sub = await client.readContract({
-            address: contractAddress,
-            abi: MPA_WALLET_READ_ABI,
-            functionName: 'getSubscriptionStatus',
-            args: [keyGenId, KEY_GEN_ADDRESS_KIND_ETHEREUM],
-        });
-        const [, , signatureCountAtMonthStart, nodeCreditBalance, monthlyFee, freeSignaturesPerMonth, , fundedForCurrentMonth] = sub;
-        const currentNonce = globalNonce ??
-            (await client.getTransactionCount({ address: billingAddress, blockTag: 'pending' }));
-        const [remainingNonces, requiredTopUp] = await Promise.all([
-            client.readContract({
-                address: contractAddress,
-                abi: MPA_WALLET_READ_ABI,
-                functionName: 'getRemainingNonces',
-                args: [keyGenId, KEY_GEN_ADDRESS_KIND_ETHEREUM, BigInt(currentNonce)],
-            }),
-            client.readContract({
-                address: contractAddress,
-                abi: MPA_WALLET_READ_ABI,
-                functionName: 'getRequiredMinimumTopUp',
-                args: [keyGenId, KEY_GEN_ADDRESS_KIND_ETHEREUM],
-            }),
-        ]);
-        const feeToken = await client.readContract({
-            address: contractAddress,
-            abi: MPA_WALLET_READ_ABI,
-            functionName: 'FEE_TOKEN',
-        });
-        const [symbol, decimals] = await Promise.all([
-            client.readContract({
-                address: feeToken,
-                abi: ERC20_SYMBOL_DECIMALS_ABI,
-                functionName: 'symbol',
-            }),
-            client.readContract({
-                address: feeToken,
-                abi: ERC20_SYMBOL_DECIMALS_ABI,
-                functionName: 'decimals',
-            }),
-        ]);
-        const d = Number(decimals ?? 18);
-        const usedThisMonth = Math.max(0, currentNonce - Number(signatureCountAtMonthStart));
-        const freeLeft = fundedForCurrentMonth
-            ? Math.max(0, Number(freeSignaturesPerMonth) - usedThisMonth)
-            : 0;
-        return {
-            ok: true,
-            data: {
-                registered: true,
-                freeTransactionsLeft: freeLeft,
-                remainingDeposit: formatUnits(nodeCreditBalance, d),
-                feeTokenSymbol: symbol ?? 'TOKEN',
-                remainingNonces: Number(remainingNonces),
-                globalNonce: currentNonce,
-                requiredMinimumTopUpWei: requiredTopUp.toString(),
-                monthlyFee: formatUnits(monthlyFee, d),
-                hasEverDeposited: nodeCreditBalance > 0n,
-            },
-        };
+        const data = await fetchMergedMpaWalletStatus(config, parsed.data.keyGenId, eth);
+        return { ok: true, data };
     }
     catch (e) {
         return {
@@ -130,11 +60,18 @@ export async function getMpaWalletStatus(config, input) {
             data: {
                 registered: false,
                 error: e instanceof Error ? e.message : 'Failed to load MPA wallet status',
-                globalNonce,
             },
         };
     }
 }
+async function resolveGlobalNonceForSync(config, keyGenId, billingAddress) {
+    const fromNode = await fetchGlobalNonceByKeyGenId(config, keyGenId);
+    if (fromNode.ok)
+        return fromNode;
+    const client = getMpaPublicClient();
+    const nonce = await client.getTransactionCount({ address: billingAddress, blockTag: 'pending' });
+    return { ok: true, data: nonce };
+}
 export async function createMpaTopUpMultiSignRequest(config, input) {
     const parsed = MpaTopUpInputSchema.safeParse(input);
     if (!parsed.success) {
@@ -151,6 +88,8 @@ export async function createMpaTopUpMultiSignRequest(config, input) {
     const billingAddress = getAddress(eth.startsWith('0x') ? eth : `0x${eth}`);
     const mpa = MPA_WALLET_CONTRACT_CONFIG.contractAddress;
     const keyGenId = parsed.data.keyGenId;
+    const amountWei = BigInt(parsed.data.amountWei);
+    const walletStatus = await fetchMergedMpaWalletStatus(config, keyGenId, eth);
     const sub = await client.readContract({
         address: mpa,
         abi: MPA_WALLET_READ_ABI,
@@ -174,7 +113,6 @@ export async function createMpaTopUpMultiSignRequest(config, input) {
         abi: ERC20_SYMBOL_DECIMALS_ABI,
         functionName: 'decimals',
     });
-    const amountWei = BigInt(parsed.data.amountWei);
     const minWei = requiredTopUp > 0n ? requiredTopUp : monthlyFee;
     if (amountWei < minWei) {
         return {
@@ -210,10 +148,30 @@ export async function createMpaTopUpMultiSignRequest(config, input) {
             { name: 'globalNonceAtActivation', type: 'uint256', value: globalNonceAtActivation },
         ],
     });
+    const syncAfterDeposit = parsed.data.activateBillingMonthAfterDeposit === true &&
+        shouldSyncKeyGenMonthAfterDeposit(walletStatus, amountWei);
+    if (syncAfterDeposit) {
+        const globalNonce = await resolveGlobalNonceForSync(config, keyGenId, billingAddress);
+        if (!globalNonce.ok)
+            return globalNonce;
+        actions.push({
+            signature: 'syncBilling(string,string,uint256)',
+            contractAddress: mpa,
+            args: [
+                { name: 'keyGenId', type: 'string', value: keyGenId },
+                { name: 'addressKind', type: 'string', value: KEY_GEN_ADDRESS_KIND_ETHEREUM },
+                { name: 'globalNonceAtActivation', type: 'uint256', value: String(globalNonce.data) },
+            ],
+        });
+    }
+    const purpose = parsed.data.purpose ??
+        (syncAfterDeposit
+            ? 'Top up MPA signing credits and activate billing month'
+            : 'Top up MPA signing credits');
     const built = await buildMultiSignProposal(config, {
         keyGenResult: kg.data,
         chainId: MPA_WALLET_CONTRACT_CONFIG.chainId,
-        purpose: parsed.data.purpose ?? 'Top up MPA signing credits',
+        purpose,
         useCustomGas: parsed.data.useCustomGas,
         startingNonce: parsed.data.startingNonce,
         actions,