@aephia/atlas-kit 0.0.0

package/dist/markets/index.d.ts

@@ -0,0 +1,195 @@
+import type { Address, ReadOptions, SageContext } from '../client/index.js';
+import { type EntityRef } from '../client/refs.js';
+import { type FactionMarketAccountData, type LocalMarketAccountData, type LocalMarketMakerData, type LocalMarketOrderData } from '../internal/c4/market.js';
+import { type CargoDefinitionSummary } from '../registry/index.js';
+/** Derives a Local Market PDA from its verified generated seeds.
+ * @example
+ * ```ts
+ * declare const system: Address;
+ * const address = await deriveLocalMarketAddress(system, 1, 0n);
+ * ```
+ */
+export declare function deriveLocalMarketAddress(system: Address, cargoId: number, starbaseSequenceId: bigint): Promise<Address>;
+/** Derives a Faction Market PDA from its verified generated seeds.
+ * @example
+ * ```ts
+ * declare const game: Address;
+ * declare const system: Address;
+ * const address = await deriveFactionMarketAddress(game, system, 0n);
+ * ```
+ */
+export declare function deriveFactionMarketAddress(game: Address, system: Address, starbaseSequenceId: bigint): Promise<Address>;
+/** Discovery controls for Local Market finders.
+ * @example
+ * ```ts
+ * const options: MarketDiscoveryOptions = { commitment: 'confirmed' };
+ * ```
+ */
+export interface MarketDiscoveryOptions extends ReadOptions {
+    readonly signal?: AbortSignal;
+}
+/** One translated Local Market order.
+ * @example
+ * ```ts
+ * declare const order: LocalMarketOrderSnapshot;
+ * console.log(order.side, order.priceAtlas);
+ * ```
+ */
+export interface LocalMarketOrderSnapshot extends LocalMarketOrderData {
+    readonly makerRef: EntityRef<'character'>;
+}
+/** One Character's maker state on one order-book side.
+ *
+ * `escrowedOrReleasedAtlas` is escrowed ATLAS for bids and ATLAS released from
+ * completed sales for asks. It does not establish that either amount is
+ * currently withdrawable.
+ *
+ * @example
+ * ```ts
+ * declare const makerState: LocalMarketMakerStateSnapshot;
+ * console.log(makerState.escrowedOrReleasedAtlas);
+ * ```
+ */
+export interface LocalMarketMakerStateSnapshot extends LocalMarketMakerData {
+    readonly characterRef: EntityRef<'character'>;
+}
+/** One translated side of a Local Market order book.
+ * @example
+ * ```ts
+ * declare const book: LocalMarketOrderBookSnapshot;
+ * console.log(book.orders.length);
+ * ```
+ */
+export interface LocalMarketOrderBookSnapshot {
+    readonly nextOrderIdRaw: bigint;
+    readonly makers: readonly LocalMarketMakerStateSnapshot[];
+    readonly orders: readonly LocalMarketOrderSnapshot[];
+}
+/** Immutable Local Market, order book, escrow, and maker-state snapshot.
+ * @example
+ * ```ts
+ * declare const market: LocalMarketSnapshot;
+ * console.log(market.cargo.name, market.asks.orders);
+ * ```
+ */
+export interface LocalMarketSnapshot extends Omit<LocalMarketAccountData, 'asks' | 'bids' | 'cargo' | 'initializerProfile' | 'system'> {
+    readonly kind: 'localMarket';
+    readonly address: Address;
+    readonly system: EntityRef<'starSystem'>;
+    readonly initializerProfile: EntityRef<'profile'>;
+    readonly cargo: CargoDefinitionSummary & {
+        readonly amountRaw: bigint;
+    };
+    readonly bids: LocalMarketOrderBookSnapshot;
+    readonly asks: LocalMarketOrderBookSnapshot;
+    toJSON(): unknown;
+}
+/** One cargo offer in a Faction Market.
+ * @example
+ * ```ts
+ * declare const offer: FactionMarketOfferSnapshot;
+ * console.log(offer.name, offer.priceAtlas);
+ * ```
+ */
+export interface FactionMarketOfferSnapshot extends CargoDefinitionSummary {
+    readonly canBuyFromFaction: boolean;
+    readonly canSellToFaction: boolean;
+    readonly priceRaw: bigint;
+    readonly priceAtlas: number;
+    readonly remainingQuantityRaw: bigint;
+}
+/** Immutable Faction Market configuration, lifecycle, and offers snapshot.
+ * @example
+ * ```ts
+ * declare const market: FactionMarketSnapshot;
+ * console.log(market.status, market.offers);
+ * ```
+ */
+export interface FactionMarketSnapshot extends Omit<FactionMarketAccountData, 'game' | 'offers' | 'system'> {
+    readonly kind: 'factionMarket';
+    readonly address: Address;
+    readonly game: EntityRef<'game'>;
+    readonly system: EntityRef<'starSystem'>;
+    readonly offers: readonly FactionMarketOfferSnapshot[];
+    toJSON(): unknown;
+}
+/** Reads one required Local Market by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const market = await getLocalMarket(ctx, address);
+ * ```
+ */
+export declare function getLocalMarket(context: SageContext, address: Address, options?: ReadOptions): Promise<LocalMarketSnapshot>;
+/** Reads one optional Local Market by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const market = await maybeGetLocalMarket(ctx, address);
+ * ```
+ */
+export declare function maybeGetLocalMarket(context: SageContext, address: Address, options?: ReadOptions): Promise<LocalMarketSnapshot | undefined>;
+/** Derives and reads a Local Market for cargo at one Starbase incarnation.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const system: Address;
+ * const market = await getLocalMarketForCargo(ctx, system, 1, 0n);
+ * ```
+ */
+export declare function getLocalMarketForCargo(context: SageContext, system: Address, cargoId: number, starbaseSequenceId: bigint, options?: ReadOptions): Promise<LocalMarketSnapshot>;
+/** Discovers all Local Markets stored for one Star System.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const system: Address;
+ * const markets = await getLocalMarketsBySystem(ctx, system);
+ * ```
+ */
+export declare function getLocalMarketsBySystem(context: SageContext, system: Address, options?: MarketDiscoveryOptions): Promise<readonly LocalMarketSnapshot[]>;
+/** Returns one Character's open orders with that side's maker state.
+ *
+ * Bid-side ATLAS is escrowed for buy orders. Ask-side ATLAS was released from
+ * completed sell orders. Neither interpretation promises withdrawability.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const market: Address;
+ * declare const character: Address;
+ * const orders = await getLocalMarketOrdersByCharacter(ctx, market, character);
+ * ```
+ */
+export declare function getLocalMarketOrdersByCharacter(context: SageContext, market: Address, character: Address, options?: ReadOptions): Promise<readonly (LocalMarketOrderSnapshot & {
+    readonly makerState: LocalMarketMakerStateSnapshot;
+})[]>;
+/** Reads one required Faction Market by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const market = await getFactionMarket(ctx, address);
+ * ```
+ */
+export declare function getFactionMarket(context: SageContext, address: Address, options?: ReadOptions): Promise<FactionMarketSnapshot>;
+/** Reads one optional Faction Market by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const market = await maybeGetFactionMarket(ctx, address);
+ * ```
+ */
+export declare function maybeGetFactionMarket(context: SageContext, address: Address, options?: ReadOptions): Promise<FactionMarketSnapshot | undefined>;
+/** Derives and reads the configured Game's Faction Market at one Starbase incarnation.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const system: Address;
+ * const market = await getFactionMarketForSystem(ctx, system, 0n);
+ * ```
+ */
+export declare function getFactionMarketForSystem(context: SageContext, system: Address, starbaseSequenceId: bigint, options?: ReadOptions): Promise<FactionMarketSnapshot>;
+//# sourceMappingURL=index.d.ts.map

package/dist/markets/index.d.ts.map

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

package/dist/markets/index.js

@@ -0,0 +1,232 @@
+import { AccountDecodeError } from '../client/errors.js';
+import { entityRef } from '../client/refs.js';
+import { deriveFactionMarketAddress as deriveFactionMarketAddressInternal, deriveLocalMarketAddress as deriveLocalMarketAddressInternal, discoverLocalMarketsBySystem, factionMarketAccountDefinition, localMarketAccountDefinition, } from '../internal/c4/market.js';
+import { requireGameAddress } from '../internal/game-context.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { attachReadMeta, readMeta } from '../internal/read-meta.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+import { resolveCargo, } from '../registry/index.js';
+/** Derives a Local Market PDA from its verified generated seeds.
+ * @example
+ * ```ts
+ * declare const system: Address;
+ * const address = await deriveLocalMarketAddress(system, 1, 0n);
+ * ```
+ */
+export function deriveLocalMarketAddress(system, cargoId, starbaseSequenceId) {
+    return deriveLocalMarketAddressInternal(system, cargoId, starbaseSequenceId);
+}
+/** Derives a Faction Market PDA from its verified generated seeds.
+ * @example
+ * ```ts
+ * declare const game: Address;
+ * declare const system: Address;
+ * const address = await deriveFactionMarketAddress(game, system, 0n);
+ * ```
+ */
+export function deriveFactionMarketAddress(game, system, starbaseSequenceId) {
+    return deriveFactionMarketAddressInternal(game, system, starbaseSequenceId);
+}
+function directMetadata(envelope) {
+    return {
+        commitment: envelope.commitment,
+        slot: envelope.slot,
+        source: envelope.source,
+        strategy: 'direct',
+    };
+}
+function order(value) {
+    return { ...value, makerRef: entityRef('character', value.maker) };
+}
+function makerState(value) {
+    return { ...value, characterRef: entityRef('character', value.character) };
+}
+function book(value) {
+    return {
+        makers: value.makers.map(makerState),
+        nextOrderIdRaw: value.nextOrderIdRaw,
+        orders: value.orders.map(order),
+    };
+}
+const LOCAL_SNAPSHOTS = new WeakMap();
+const FACTION_SNAPSHOTS = new WeakMap();
+async function createLocalSnapshot(context, envelope) {
+    const expected = await deriveLocalMarketAddress(envelope.data.system, envelope.data.cargo.cargoId, envelope.data.starbaseSequenceId);
+    if (expected !== envelope.address) {
+        throw new AccountDecodeError('market', envelope.address, new RangeError('The decoded Local Market contradicted its PDA seeds.'), `Local Market ${envelope.address} is not derived from its Star System, cargo id, and Starbase sequence. Verify the address and pinned generated source before retrying.`);
+    }
+    const { asks, bids, cargo, initializerProfile, system, ...data } = envelope.data;
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+        ...data,
+        address: envelope.address,
+        asks: book(asks),
+        bids: book(bids),
+        cargo: {
+            ...(await resolveCargo(context, cargo.cargoId)),
+            amountRaw: cargo.amountRaw,
+        },
+        initializerProfile: entityRef('profile', initializerProfile),
+        kind: 'localMarket',
+        system: entityRef('starSystem', system),
+    }), directMetadata(envelope)));
+}
+function toLocalSnapshot(context, envelope) {
+    const existing = LOCAL_SNAPSHOTS.get(envelope);
+    if (existing !== undefined)
+        return existing;
+    const pending = createLocalSnapshot(context, envelope);
+    LOCAL_SNAPSHOTS.set(envelope, pending);
+    void pending.catch(() => LOCAL_SNAPSHOTS.delete(envelope));
+    return pending;
+}
+async function createFactionSnapshot(context, envelope) {
+    const game = requireGameAddress(context);
+    if (envelope.data.game !== game) {
+        throw new AccountDecodeError('market', envelope.address, new RangeError('The decoded Faction Market references another Game.'), `Faction Market ${envelope.address} belongs to Game ${envelope.data.game}, not configured Game ${game}. Verify the cluster and address before retrying.`);
+    }
+    const expected = await deriveFactionMarketAddress(game, envelope.data.system, envelope.data.starbaseSequenceId);
+    if (expected !== envelope.address) {
+        throw new AccountDecodeError('market', envelope.address, new RangeError('The decoded Faction Market contradicted its PDA seeds.'), `Faction Market ${envelope.address} is not derived from its configured Game, Star System, and Starbase sequence. Verify the address and pinned generated source before retrying.`);
+    }
+    const { game: _game, offers, system, ...data } = envelope.data;
+    const resolvedOffers = await Promise.all(offers.map(async ({ cargoId, ...offer }) => ({
+        ...(await resolveCargo(context, cargoId)),
+        ...offer,
+    })));
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+        ...data,
+        address: envelope.address,
+        game: entityRef('game', game),
+        kind: 'factionMarket',
+        offers: resolvedOffers,
+        system: entityRef('starSystem', system),
+    }), directMetadata(envelope)));
+}
+function toFactionSnapshot(context, envelope) {
+    const existing = FACTION_SNAPSHOTS.get(envelope);
+    if (existing !== undefined)
+        return existing;
+    const pending = createFactionSnapshot(context, envelope);
+    FACTION_SNAPSHOTS.set(envelope, pending);
+    void pending.catch(() => FACTION_SNAPSHOTS.delete(envelope));
+    return pending;
+}
+/** Reads one required Local Market by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const market = await getLocalMarket(ctx, address);
+ * ```
+ */
+export async function getLocalMarket(context, address, options) {
+    return toLocalSnapshot(context, await context.data.read(localMarketAccountDefinition, address, options));
+}
+/** Reads one optional Local Market by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const market = await maybeGetLocalMarket(ctx, address);
+ * ```
+ */
+export async function maybeGetLocalMarket(context, address, options) {
+    const [envelope] = await context.data.readMany(localMarketAccountDefinition, [address], options);
+    return envelope === undefined
+        ? undefined
+        : toLocalSnapshot(context, envelope);
+}
+/** Derives and reads a Local Market for cargo at one Starbase incarnation.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const system: Address;
+ * const market = await getLocalMarketForCargo(ctx, system, 1, 0n);
+ * ```
+ */
+export async function getLocalMarketForCargo(context, system, cargoId, starbaseSequenceId, options) {
+    return getLocalMarket(context, await deriveLocalMarketAddress(system, cargoId, starbaseSequenceId), options);
+}
+/** Discovers all Local Markets stored for one Star System.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const system: Address;
+ * const markets = await getLocalMarketsBySystem(ctx, system);
+ * ```
+ */
+export async function getLocalMarketsBySystem(context, system, options) {
+    const envelopes = await discoverLocalMarketsBySystem(context, system, options);
+    const meta = readMeta(envelopes);
+    return Object.freeze(attachReadMeta(await Promise.all(envelopes.map((envelope) => toLocalSnapshot(context, envelope))), meta));
+}
+/** Returns one Character's open orders with that side's maker state.
+ *
+ * Bid-side ATLAS is escrowed for buy orders. Ask-side ATLAS was released from
+ * completed sell orders. Neither interpretation promises withdrawability.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const market: Address;
+ * declare const character: Address;
+ * const orders = await getLocalMarketOrdersByCharacter(ctx, market, character);
+ * ```
+ */
+export async function getLocalMarketOrdersByCharacter(context, market, character, options) {
+    const snapshot = await getLocalMarket(context, market, options);
+    const matches = (side) => {
+        const orders = side.orders.filter((value) => value.maker === character);
+        if (orders.length === 0)
+            return [];
+        const maker = side.makers.find((value) => value.character === character);
+        if (maker === undefined) {
+            throw new AccountDecodeError('market', market, new RangeError('The decoded Local Market contains matching orders without their MakerInfo state entry.'), `Local Market ${market} contains orders for Character ${character} without that Character's maker state entry. Refresh the Market account and verify the provider and installed binding version before retrying.`);
+        }
+        return orders.map((value) => ({ ...value, makerState: maker }));
+    };
+    return freezeResolvedSnapshot([
+        ...matches(snapshot.bids),
+        ...matches(snapshot.asks),
+    ]);
+}
+/** Reads one required Faction Market by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const market = await getFactionMarket(ctx, address);
+ * ```
+ */
+export async function getFactionMarket(context, address, options) {
+    requireGameAddress(context);
+    return toFactionSnapshot(context, await context.data.read(factionMarketAccountDefinition, address, options));
+}
+/** Reads one optional Faction Market by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const market = await maybeGetFactionMarket(ctx, address);
+ * ```
+ */
+export async function maybeGetFactionMarket(context, address, options) {
+    requireGameAddress(context);
+    const [envelope] = await context.data.readMany(factionMarketAccountDefinition, [address], options);
+    return envelope === undefined
+        ? undefined
+        : toFactionSnapshot(context, envelope);
+}
+/** Derives and reads the configured Game's Faction Market at one Starbase incarnation.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const system: Address;
+ * const market = await getFactionMarketForSystem(ctx, system, 0n);
+ * ```
+ */
+export async function getFactionMarketForSystem(context, system, starbaseSequenceId, options) {
+    const game = requireGameAddress(context);
+    return getFactionMarket(context, await deriveFactionMarketAddress(game, system, starbaseSequenceId), options);
+}
+//# sourceMappingURL=index.js.map

package/dist/markets/index.js.map

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

package/dist/mining/index.d.ts

@@ -0,0 +1,156 @@
+import { type Address, type DiscoveryRequest, type EntityRef, type ReadOptions, type SageContext } from '../client/index.js';
+import { type WorldFixedValue } from '../internal/c4/world.js';
+import { type CargoDefinitionSummary } from '../registry/index.js';
+/** One registry-resolved resource row nested in an Asteroid deposit.
+ * @example
+ * ```ts
+ * declare const resource: ResourceDepositItem;
+ * console.log(resource.cargo.name, resource.richness.value);
+ * ```
+ */
+export interface ResourceDepositItem {
+    readonly cargo: CargoDefinitionSummary;
+    readonly richness: WorldFixedValue;
+    readonly amountMinedUnitsRaw: bigint;
+    readonly activeMinerCountRaw: bigint;
+}
+/** Immutable, translated Asteroid resource-deposit snapshot.
+ * @example
+ * ```ts
+ * declare const deposit: ResourceDepositSnapshot;
+ * console.log(deposit.resources);
+ * ```
+ */
+export interface ResourceDepositSnapshot {
+    readonly kind: 'resourceDeposit';
+    readonly address: Address;
+    readonly bodyId: number;
+    readonly name: string;
+    readonly game: Address;
+    readonly system: EntityRef<'starSystem'>;
+    readonly systemSequenceId: bigint;
+    readonly lastSyncedAtUnixSeconds: bigint;
+    readonly resources: readonly ResourceDepositItem[];
+    toJSON(): unknown;
+}
+/** A pure rate input pairing one cargo id with Asteroid richness.
+ * @example
+ * ```ts
+ * const input: MiningOutputRateInput = { cargoId: 8, richness: 1.5 };
+ * ```
+ */
+export interface MiningOutputRateInput {
+    readonly cargoId: number;
+    readonly richness: number;
+}
+/** One richness-adjusted resource output in cargo units per second.
+ * @example
+ * ```ts
+ * const rate: MiningOutputRate = { cargoId: 8, unitsPerSecond: 4.5 };
+ * ```
+ */
+export interface MiningOutputRate {
+    readonly cargoId: number;
+    readonly unitsPerSecond: number;
+}
+/** One selected and registry-resolved output of an active mining Fleet.
+ * @example
+ * ```ts
+ * declare const output: FleetMiningOutput;
+ * console.log(output.cargo.name, output.unitsPerSecond);
+ * ```
+ */
+export interface FleetMiningOutput extends ResourceDepositItem {
+    readonly unitsPerSecond: number;
+}
+/** Immutable current extraction relationship for one active mining Fleet.
+ * @example
+ * ```ts
+ * declare const mining: FleetMiningSnapshot;
+ * console.log(mining.outputs);
+ * ```
+ */
+export interface FleetMiningSnapshot {
+    readonly kind: 'fleetMining';
+    readonly fleet: EntityRef<'fleet'>;
+    readonly ownerProfile: EntityRef<'profile'>;
+    readonly asteroid: EntityRef<'celestialBody'>;
+    readonly lastUpdatedAtUnixSeconds: bigint;
+    readonly regionXpModifier: WorldFixedValue;
+    readonly miningRate: {
+        readonly raw: bigint;
+        readonly unitsPerSecond: number;
+    };
+    readonly outputs: readonly FleetMiningOutput[];
+    toJSON(): unknown;
+}
+/** Options supported by owner-scoped active-mining discovery.
+ * @example
+ * ```ts
+ * const options: MiningDiscoveryOptions = { commitment: 'confirmed' };
+ * ```
+ */
+export type MiningDiscoveryOptions = Omit<DiscoveryRequest, 'filters' | 'strategy'>;
+/** Reads a required Asteroid resource deposit by CelestialBody address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const asteroid: Address;
+ * const deposit = await getResourceDeposit(ctx, asteroid);
+ * ```
+ */
+export declare function getResourceDeposit(context: SageContext, asteroid: Address, options?: ReadOptions): Promise<ResourceDepositSnapshot>;
+/** Reads an optional Asteroid resource deposit by CelestialBody address.
+ *
+ * Returns `undefined` only when the account does not exist. A present
+ * non-Asteroid CelestialBody throws {@link AccountDecodeError} because it is
+ * not a resource deposit.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const asteroid: Address;
+ * const deposit = await maybeGetResourceDeposit(ctx, asteroid);
+ * ```
+ */
+export declare function maybeGetResourceDeposit(context: SageContext, asteroid: Address, options?: ReadOptions): Promise<ResourceDepositSnapshot | undefined>;
+/** Derives mining-state age in whole seconds and clamps future timestamps.
+ * @example
+ * ```ts
+ * const age = deriveMiningStateAgeSeconds(100n, 112n); // 12
+ * ```
+ */
+export declare function deriveMiningStateAgeSeconds(lastUpdatedAtUnixSeconds: bigint, atUnixSeconds: bigint): number;
+/** Derives each selected output rate as Fleet units/second times deposit richness.
+ * @example
+ * ```ts
+ * const rates = deriveMiningOutputRates(2, [{ cargoId: 8, richness: 1.5 }]);
+ * ```
+ */
+export declare function deriveMiningOutputRates(fleetUnitsPerSecond: number, outputs: readonly MiningOutputRateInput[]): readonly MiningOutputRate[];
+/** Projects nominal output units from a rate and elapsed seconds.
+ * @example
+ * ```ts
+ * const units = projectMiningOutputUnits(4.5, 20); // 90
+ * ```
+ */
+export declare function projectMiningOutputUnits(unitsPerSecond: number, elapsedSeconds: number): number;
+/** Reads a Fleet and returns its active extraction relationship, if mining.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleet: Address;
+ * const mining = await getFleetMiningState(ctx, fleet);
+ * ```
+ */
+export declare function getFleetMiningState(context: SageContext, fleet: Address, options?: ReadOptions): Promise<FleetMiningSnapshot | undefined>;
+/** Finds active mining Fleets for one owner through stable Fleet filters.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const owner: Address;
+ * const mining = await getFleetMiningStatesByOwner(ctx, owner);
+ * ```
+ */
+export declare function getFleetMiningStatesByOwner(context: SageContext, owner: Address, options?: MiningDiscoveryOptions): Promise<readonly FleetMiningSnapshot[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mining/index.d.ts.map

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