@antseed/ants 0.1.1

package/dist/service/seller.js

@@ -0,0 +1,104 @@
+import { ZeroAddress } from 'ethers';
+import { formatAnts } from './format.js';
+import { toJson } from './json.js';
+import { silentReporter } from './steps.js';
+async function safe(read, fallback) {
+    try {
+        return await read();
+    }
+    catch {
+        return fallback;
+    }
+}
+export async function seller(ctx) {
+    const stack = await ctx.stack();
+    const identity = ctx.identity();
+    const registry = ctx.sellerRegistry();
+    const legacyStaking = ctx.legacyStakingAt(stack.legacyStaking);
+    const pools = ctx.pools();
+    const init = ctx.positionInit();
+    const [identityRegistered, registryAgentId, legacyAgentId, legacyStake, legacyEligible, registryEligible, legacyEligibilityEnabled, minPoolStake] = await Promise.all([
+        identity ? safe(() => identity.isRegistered(ctx.address), false) : Promise.resolve(false),
+        registry ? safe(() => registry.getAgentId(ctx.address), 0) : Promise.resolve(0),
+        legacyStaking ? safe(() => legacyStaking.getAgentId(ctx.address), 0) : Promise.resolve(0),
+        legacyStaking ? safe(() => legacyStaking.getStake(ctx.address), 0n) : Promise.resolve(0n),
+        legacyStaking ? safe(() => legacyStaking.isStakedAboveMin(ctx.address), false) : Promise.resolve(false),
+        registry ? safe(() => registry.isStakedAboveMin(ctx.address), false) : Promise.resolve(false),
+        registry ? safe(() => registry.legacyStakeEligibilityEnabled(), null) : Promise.resolve(null),
+        registry ? safe(() => registry.minSellerPoolStake(), null) : Promise.resolve(null),
+    ]);
+    const agentId = registryAgentId || legacyAgentId;
+    const poolActiveStake = pools && agentId ? await safe(() => pools.poolActiveStakeAtEpoch(agentId, stack.currentEpoch), 0n) : 0n;
+    let starter = null;
+    if (init && pools) {
+        const [initialized, remaining, amount, endEpoch, activationDelay] = await Promise.all([
+            agentId ? safe(() => init.agentInitialized(agentId), false) : Promise.resolve(false),
+            safe(() => init.remainingInits(), 0n), safe(() => init.initAmount(), 0n), safe(() => init.initEndEpoch(), 0), safe(() => pools.stakeActivationDelay(), 1),
+        ]);
+        const legacyStarterEligible = legacyAgentId !== 0 && legacyEligible;
+        const expired = stack.currentEpoch + activationDelay >= endEpoch;
+        starter = {
+            contract: init.contractAddress, initialized, remaining: remaining.toString(), amount: amount.toString(), endEpoch,
+            legacyEligible: legacyStarterEligible, expired, claimable: legacyStarterEligible && !initialized && !expired && remaining > 0n,
+        };
+    }
+    return toJson({
+        address: ctx.address,
+        agentId,
+        identityRegistered,
+        registryBound: registryAgentId !== 0,
+        eligible: stack.phase === 'active' ? registryEligible : legacyEligible,
+        legacyStake: legacyStake.toString(),
+        legacyEligibilityEnabled,
+        minPoolStake: minPoolStake === null ? null : minPoolStake.toString(),
+        poolActiveStake: poolActiveStake.toString(),
+        starter,
+    });
+}
+export async function registerBinding(ctx, agentIdInput, report = silentReporter) {
+    const signer = ctx.requireSigner();
+    const registry = ctx.sellerRegistry();
+    if (!registry)
+        throw new Error('Seller registry is not configured; use `antseed seller register` on this chain.');
+    const stack = await ctx.stack();
+    const legacyStaking = ctx.legacyStakingAt(stack.legacyStaking);
+    const agentId = agentIdInput ?? (legacyStaking ? await safe(() => legacyStaking.getAgentId(ctx.address), 0) : 0);
+    if (!agentId)
+        throw new Error('No agent ID known for this wallet. Register an identity first with `antseed seller register`.');
+    const identity = ctx.identity();
+    if (identity) {
+        const owner = await safe(() => identity.getAgentWallet(agentId), ZeroAddress);
+        if (owner.toLowerCase() !== ctx.address.toLowerCase())
+            throw new Error(`Agent ${agentId} is owned by ${owner}, not this wallet.`);
+    }
+    await report(`Binding agent ${agentId} to ${ctx.address} in the seller registry`);
+    let sent = false;
+    await registry.registerSellerBinding(signer, agentId, async (hash) => { sent = true; await report('Registration confirmed', hash); });
+    if (!sent)
+        await report('Registration already complete; nothing sent');
+    ctx.invalidate();
+    return { agentId, sent };
+}
+export async function claimStarter(ctx, report = silentReporter) {
+    const signer = ctx.requireSigner();
+    const init = ctx.positionInit();
+    if (!init)
+        throw new Error('Starter positions are not configured for this chain.');
+    const view = await seller(ctx);
+    if (!view.starter)
+        throw new Error('Starter positions are unavailable.');
+    if (view.starter.initialized)
+        throw new Error(`Starter position already initialized for agent ${view.agentId}.`);
+    if (!view.starter.legacyEligible)
+        throw new Error('Starter grants require a legacy USDC stake at or above the minimum bound to this wallet.');
+    if (view.starter.expired)
+        throw new Error(`Starter initialization closed at epoch ${view.starter.endEpoch}.`);
+    if (BigInt(view.starter.remaining) === 0n)
+        throw new Error('The starter faucet is depleted.');
+    await report(`Creating ${formatAnts(view.starter.amount)} ANTS starter position for agent ${view.agentId} (locked through epoch ${view.starter.endEpoch})`);
+    const hash = await init.initPosition(signer);
+    await report('Starter position created', hash);
+    ctx.invalidate();
+    return { hash, agentId: view.agentId, amount: view.starter.amount, endEpoch: view.starter.endEpoch };
+}
+//# sourceMappingURL=seller.js.map

package/dist/service/seller.js.map

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

package/dist/service/steps.d.ts

@@ -0,0 +1,6 @@
+/** Progress callback used by every multi-transaction action. */
+export type StepReporter = (label: string, hash?: string) => void | Promise<void>;
+export declare const silentReporter: StepReporter;
+export declare function assertPositiveIds(ids: unknown): number[];
+export declare function assertEpochs(epochs: unknown, min: number, max: number): number;
+export declare function assertAgentId(agentId: unknown): number;

package/dist/service/steps.js

@@ -0,0 +1,24 @@
+export const silentReporter = () => { };
+export function assertPositiveIds(ids) {
+    if (!Array.isArray(ids) || ids.length === 0)
+        throw new Error('At least one position ID is required.');
+    const parsed = ids.map((value) => Number(value));
+    if (parsed.some((id) => !Number.isSafeInteger(id) || id <= 0))
+        throw new Error('Position IDs must be positive integers.');
+    if (new Set(parsed).size !== parsed.length)
+        throw new Error('Position IDs must not repeat.');
+    return parsed;
+}
+export function assertEpochs(epochs, min, max) {
+    const value = Number(epochs);
+    if (!Number.isInteger(value) || value < min || value > max)
+        throw new Error(`Lock length must be a whole number of epochs between ${min} and ${max}.`);
+    return value;
+}
+export function assertAgentId(agentId) {
+    const value = Number(agentId);
+    if (!Number.isSafeInteger(value) || value <= 0)
+        throw new Error('Agent ID must be a positive integer.');
+    return value;
+}
+//# sourceMappingURL=steps.js.map

package/dist/service/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/service/steps.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,cAAc,GAAiB,GAAG,EAAE,GAAE,CAAC,CAAC;AAErD,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACtG,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC1H,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC7F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAe,EAAE,GAAW,EAAE,GAAW;IACpE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC;IACvJ,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACxG,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/service/usage.d.ts

@@ -0,0 +1,10 @@
+import type { AntsContext } from './context.js';
+import type { UsageView } from '../api-types.js';
+/**
+ * Your buyer and seller usage per epoch with network totals. The per-epoch
+ * series comes from the indexer (no per-epoch chain reads); only the
+ * wallet's lifetime totals and the accounting policies are read live.
+ */
+export declare function usage(ctx: AntsContext, options?: {
+    epochs?: number;
+}): Promise<UsageView>;

package/dist/service/usage.js

@@ -0,0 +1,77 @@
+import { ZeroAddress } from 'ethers';
+import { toJson } from './json.js';
+import { IndexerError } from './indexer.js';
+async function safe(read, fallback) {
+    try {
+        return await read();
+    }
+    catch {
+        return fallback;
+    }
+}
+/**
+ * Your buyer and seller usage per epoch with network totals. The per-epoch
+ * series comes from the indexer (no per-epoch chain reads); only the
+ * wallet's lifetime totals and the accounting policies are read live.
+ */
+export async function usage(ctx, options = {}) {
+    const stack = await ctx.stack();
+    const accounting = ctx.usageAccounting();
+    const indexer = ctx.indexer();
+    const count = Math.max(1, Math.min(52, options.epochs ?? 8));
+    const first = stack.effectiveEpoch ?? 0;
+    const from = Math.max(first, stack.currentEpoch - count + 1);
+    let epochs = [];
+    let source = 'chain';
+    let sourceError = null;
+    if (indexer && stack.phase === 'active') {
+        try {
+            const [participant, network] = await Promise.all([indexer.participant(ctx.address, count), indexer.stakingEpochs(count)]);
+            source = 'indexer';
+            for (let epoch = stack.currentEpoch; epoch >= from; epoch -= 1) {
+                const seller = participant.seller.find((row) => row.epoch === epoch);
+                const buyer = participant.buyer.find((row) => row.epoch === epoch);
+                const totals = network.find((row) => row.epoch === epoch);
+                epochs.push({
+                    epoch,
+                    buyerPoints: buyer?.points ?? '0',
+                    weightedBuyerPoints: buyer?.weightedPoints ?? '0',
+                    sellerPoints: seller?.points ?? '0',
+                    agentId: seller?.agentId ?? 0,
+                    totalBuyerPoints: totals?.totalBuyerPoints ?? '0',
+                    totalSellerPoints: totals?.totalSellerPoints ?? '0',
+                    totalPoolPoints: totals?.totalSellerPoints ?? '0',
+                    totalWeightedPoolPoints: totals?.totalWeightedPoolPoints ?? '0',
+                });
+            }
+        }
+        catch (error) {
+            if (!(error instanceof IndexerError))
+                throw error;
+            sourceError = error.message;
+            epochs = [];
+        }
+    }
+    const [buyerTotal, networkTotal, pointsPolicy, poolWeightPolicy, minimumPower] = await Promise.all([
+        accounting ? safe(() => accounting.buyerUsageTotal(ctx.address), { points: 0n, weightedPoints: 0n }) : Promise.resolve({ points: 0n, weightedPoints: 0n }),
+        accounting ? safe(() => accounting.totalUsage(), { buyers: { points: 0n, weightedPoints: 0n }, sellers: { points: 0n, weightedPoints: 0n } }) : Promise.resolve({ buyers: { points: 0n, weightedPoints: 0n }, sellers: { points: 0n, weightedPoints: 0n } }),
+        accounting ? safe(() => accounting.pointsPolicy(), null) : Promise.resolve(null),
+        accounting ? safe(() => accounting.poolWeightPolicy(), null) : Promise.resolve(null),
+        accounting ? safe(() => accounting.minimumAccountedPoolPower(), null) : Promise.resolve(null),
+    ]);
+    return toJson({
+        currentEpoch: stack.currentEpoch,
+        firstRewardedEpoch: stack.effectiveEpoch,
+        epochs,
+        totals: {
+            buyerPoints: buyerTotal.points.toString(), buyerWeightedPoints: buyerTotal.weightedPoints.toString(),
+            networkBuyerPoints: networkTotal.buyers.points.toString(), networkSellerPoints: networkTotal.sellers.points.toString(),
+        },
+        pointsPolicy: pointsPolicy && pointsPolicy !== ZeroAddress ? pointsPolicy : null,
+        poolWeightPolicy: poolWeightPolicy && poolWeightPolicy !== ZeroAddress ? poolWeightPolicy : null,
+        minimumAccountedPoolPower: minimumPower === null ? null : minimumPower.toString(),
+        source,
+        sourceError,
+    });
+}
+//# sourceMappingURL=usage.js.map

package/dist/service/usage.js.map

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

package/dist/service/verification.d.ts

@@ -0,0 +1,12 @@
+import type { AntsContext } from './context.js';
+import type { VerificationView, ProofStatusView } from '../api-types.js';
+import { type StepReporter } from './steps.js';
+export declare function verification(ctx: AntsContext, seller?: string): Promise<VerificationView>;
+export declare function proofStatus(ctx: AntsContext, proofId: string): Promise<ProofStatusView>;
+export interface SubmitProofResult {
+    proofId: string;
+    seller: string;
+    finalized: boolean;
+    transactions: string[];
+}
+export declare function submitProof(ctx: AntsContext, artifact: unknown, report?: StepReporter): Promise<SubmitProofResult>;

package/dist/service/verification.js

@@ -0,0 +1,69 @@
+import { ZeroAddress } from 'ethers';
+import { validateSellerProofArtifact, sellerProofId } from '@antseed/node/payments';
+import { toJson } from './json.js';
+import { silentReporter } from './steps.js';
+async function safe(read, fallback) {
+    try {
+        return await read();
+    }
+    catch {
+        return fallback;
+    }
+}
+function sameAddress(a, b) {
+    return !!a && !!b && a.toLowerCase() === b.toLowerCase();
+}
+export async function verification(ctx, seller) {
+    const wash = ctx.washRegistry();
+    const policies = ctx.pointsPolicyRegistry();
+    const accounting = ctx.usageAccounting();
+    const target = seller ?? ctx.address;
+    if (!/^0x[0-9a-fA-F]{40}$/.test(target))
+        throw new Error('Seller must be an address.');
+    const [registry, status, policyList, pointsPolicy] = await Promise.all([
+        wash ? safe(async () => ({ address: wash.contractAddress, ...(await wash.registryConfig()) }), null) : Promise.resolve(null),
+        wash ? safe(async () => {
+            const result = await wash.sellerStatus(target);
+            return { seller: result.seller, provenWashVolume: result.provenWashVolume.toString(), totalSellerVolume: result.totalSellerVolume.toString(), provenWashShareBps: result.provenWashShareBps, evidenceDigest: result.evidenceDigest, isProvenWashTrader: result.isProvenWashTrader };
+        }, null) : Promise.resolve(null),
+        policies ? safe(() => policies.policies(), []) : Promise.resolve([]),
+        accounting ? safe(() => accounting.pointsPolicy(), null) : Promise.resolve(null),
+    ]);
+    const described = await Promise.all(policyList.map(async (address) => ({ address, washTradingRegistry: policies ? await policies.washTradingRegistryOf(address) : null })));
+    const enforced = !!pointsPolicy && sameAddress(pointsPolicy, policies?.contractAddress) && described.some((policy) => wash && sameAddress(policy.washTradingRegistry, wash.contractAddress));
+    return toJson({ registry, seller: status, policies: described, pointsPolicy: pointsPolicy && pointsPolicy !== ZeroAddress ? pointsPolicy : null, enforced });
+}
+export async function proofStatus(ctx, proofId) {
+    const wash = ctx.washRegistry();
+    if (!wash)
+        throw new Error('Wash-trading registry is not configured for this chain.');
+    if (!/^0x[0-9a-fA-F]{64}$/.test(proofId))
+        throw new Error('Proof ID must be a bytes32 hash.');
+    return toJson(await wash.proofStatus(proofId));
+}
+export async function submitProof(ctx, artifact, report = silentReporter) {
+    const wash = ctx.washRegistry();
+    if (!wash)
+        throw new Error('Wash-trading registry is not configured for this chain.');
+    const signer = ctx.requireSigner();
+    const validated = validateSellerProofArtifact(artifact);
+    const config = await wash.registryConfig();
+    if (validated.chainId !== undefined && Number(validated.chainId) !== ctx.chain.evmChainId) {
+        throw new Error(`Artifact is for chain ${validated.chainId}; this registry is on chain ${ctx.chain.evmChainId}.`);
+    }
+    const proofId = sellerProofId(validated.publicValues);
+    await report(`Submitting seller proof ${proofId} for ${validated.seller} (${validated.blockAuthenticationChunkCount} block-authentication chunk(s), period ${config.periodStartBlock}–${config.periodEndBlock})`);
+    const transactions = [];
+    const result = await wash.submitSellerProof(signer, validated, async (step) => {
+        if (step.hash)
+            transactions.push(step.hash);
+        if (step.kind === 'stage')
+            await report(step.skipped ? 'Proof already staged' : 'Proof staged (SP1 verification passed)', step.hash);
+        else if (step.kind === 'authenticate')
+            await report(`${step.skipped ? 'Already authenticated' : 'Authenticated'} block chunk ${step.chunkIndex + 1}/${step.chunkCount}`, step.hash);
+        else
+            await report(step.skipped ? 'Proof was already finalized' : 'Proof finalized', step.hash);
+    });
+    return { proofId: result.proofId, seller: validated.seller, finalized: result.finalized, transactions };
+}
+//# sourceMappingURL=verification.js.map

package/dist/service/verification.js.map

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

package/dist/view-cache.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Read-side cache for dashboard views. Public Base RPCs throttle bursts, and
+ * the failover provider fans a slow call out to every endpoint, so four tabs
+ * loading at once used to turn into minutes of 429 backoff. Reads are run one
+ * at a time (each view already batches its own calls), identical concurrent
+ * requests share one load, and results stay fresh for `ttlMs` unless a job
+ * invalidates them.
+ */
+export declare class ViewCache {
+    private readonly ttlMs;
+    private readonly entries;
+    private readonly inflight;
+    private queue;
+    constructor(ttlMs?: number);
+    read<T>(key: string, load: () => Promise<T>): Promise<T>;
+    /** Drop every cached view; in-flight loads finish and are cached as usual. */
+    invalidate(): void;
+}

package/dist/view-cache.js

@@ -0,0 +1,39 @@
+const DEFAULT_TTL_MS = 20_000;
+/**
+ * Read-side cache for dashboard views. Public Base RPCs throttle bursts, and
+ * the failover provider fans a slow call out to every endpoint, so four tabs
+ * loading at once used to turn into minutes of 429 backoff. Reads are run one
+ * at a time (each view already batches its own calls), identical concurrent
+ * requests share one load, and results stay fresh for `ttlMs` unless a job
+ * invalidates them.
+ */
+export class ViewCache {
+    ttlMs;
+    entries = new Map();
+    inflight = new Map();
+    queue = Promise.resolve();
+    constructor(ttlMs = DEFAULT_TTL_MS) {
+        this.ttlMs = ttlMs;
+    }
+    read(key, load) {
+        const hit = this.entries.get(key);
+        if (hit && Date.now() - hit.at < this.ttlMs)
+            return Promise.resolve(hit.value);
+        const running = this.inflight.get(key);
+        if (running)
+            return running;
+        const task = this.queue.then(load, load);
+        this.queue = task.catch(() => undefined);
+        this.inflight.set(key, task);
+        // Settle in the first continuation so a caller awaiting `task` never sees a stale in-flight entry.
+        const settle = () => { if (this.inflight.get(key) === task)
+            this.inflight.delete(key); };
+        task.then((value) => { this.entries.set(key, { at: Date.now(), value }); settle(); }, settle);
+        return task;
+    }
+    /** Drop every cached view; in-flight loads finish and are cached as usual. */
+    invalidate() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=view-cache.js.map

package/dist/view-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-cache.js","sourceRoot":"","sources":["../src/view-cache.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IAKS;IAJZ,OAAO,GAAG,IAAI,GAAG,EAA0C,CAAC;IAC5D,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IACxD,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEpD,YAA6B,QAAQ,cAAc;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAEvD,IAAI,CAAI,GAAW,EAAE,IAAsB;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAU,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO;YAAE,OAAO,OAAqB,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,mGAAmG;QACnG,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;YAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8EAA8E;IAC9E,UAAU;QACR,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@antseed/ants",
+  "version": "0.1.1",
+  "description": "ANTS staking dashboard and service layer for the AntSeed CLI",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./service": "./dist/service/index.js"
+  },
+  "dependencies": {
+    "@fastify/cors": "^10.0.0",
+    "@fastify/static": "^9.0.0",
+    "ethers": "^6.13.0",
+    "fastify": "^5.7.4",
+    "@antseed/node": "0.2.118"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@vitejs/plugin-react": "^4.3.0",
+    "concurrently": "^9.0.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "sass": "^1.97.3",
+    "typescript": "^5.6.0",
+    "vite": "^6.0.0",
+    "vitest": "^2.1.9"
+  },
+  "scripts": {
+    "build": "npm run build:server && npm run build:web",
+    "build:server": "tsc -p tsconfig.json",
+    "build:web": "vite build",
+    "dev": "concurrently -k \"npm:dev:web\" \"npm:dev:server\"",
+    "dev:web": "vite",
+    "dev:server": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p web/tsconfig.json"
+  }
+}