@parchment-trade/sdk 0.0.0-stage → 1.0.0

package/dist/packages/parchment/parchmentAccount.d.ts

@@ -0,0 +1,189 @@
+import type { CallerConfig } from "../../general/types/configTypes.js";
+import { Caller } from "../../general/utils/caller.js";
+import type { ApiParchmentHistoryBody, ApiParchmentAccountResponse, ApiParchmentBindReferrerTxBody, ApiParchmentBindTradingReferrerTxBody, ApiParchmentTransferAccountTxBody, ApiParchmentClaimQuestTxBody, ApiParchmentClaimTxBody, ApiParchmentExitEarlyBoundedTxBody, ApiParchmentExitEarlyTxBody, ApiParchmentReleaseUnlockedTxBody, ApiParchmentClosePreviewBody, ApiParchmentClosePreviewResponse, ApiParchmentCancelOrderAsDelegateTxBody, ApiParchmentCancelOrderTxBody, ApiParchmentCloseRetiredAsDelegateTxBody, ApiParchmentCloseRetiredTxBody, ApiParchmentEmergencyCloseAsDelegateTxBody, ApiParchmentEmergencyCloseTxBody, ApiParchmentExpireOrderTxBody, ApiParchmentRequestCloseAsDelegateTxBody, ApiParchmentRequestCloseTxBody, ApiParchmentRequestOpenAsDelegateTxBody, ApiParchmentRequestOpenTxBody, ApiParchmentDepositTxBody, ApiParchmentGameTxBody, ApiParchmentOpenCratesTxBody, ApiParchmentGrantDelegateTxBody, ApiParchmentLiquidateTxBody, ApiParchmentClaimPendingMintTxBody, ApiParchmentHistoryResponse, ApiParchmentEquityHistoryResponse, ParchmentEquityRange, ApiParchmentLpHarvestTxBody, ApiParchmentOpenPreviewBody, ApiParchmentOpenPreviewResponse, ApiParchmentRevokeDelegateTxBody, ApiParchmentStakeTxBody, ApiParchmentUnstakeTxBody, ApiParchmentWithdrawTxBody, ParchmentBuiltTx, ParchmentClaim, ParchmentPosition } from "./parchmentTypes.js";
+/** Account view plus the transactions that owner signs. */
+export declare class ParchmentAccount extends Caller {
+    readonly account: ApiParchmentAccountResponse;
+    readonly owner: string;
+    constructor(config: CallerConfig, account: ApiParchmentAccountResponse);
+    /** Positions already on this view. Does not call the network. */
+    getPositions(): ParchmentPosition[];
+    getQueue(): {
+        claims: ParchmentClaim[];
+        aheadCount: bigint;
+        aheadNet: bigint;
+    };
+    /** Re-reads the first page (service default limit) of accounts, positions and claims; follow the `*NextCursor` fields with `ParchmentClient.getAccount` for more. */
+    refresh(): Promise<ParchmentAccount>;
+    /** First page of open positions only (service default 50); the next cursor is dropped. Use `ParchmentClient.getPositions` and follow `nextCursor` before totalling exposure. */
+    refreshPositions(): Promise<ParchmentPosition[]>;
+    getHistory(input?: Omit<ApiParchmentHistoryBody, "walletAddress">): Promise<ApiParchmentHistoryResponse>;
+    /** This owner's account equity over time (hourly snapshots). */
+    getEquityHistory(range: ParchmentEquityRange): Promise<ApiParchmentEquityHistoryResponse>;
+    getPreviewOpen(input: Omit<ApiParchmentOpenPreviewBody, "marketId"> & {
+        marketId: string;
+    }): Promise<ApiParchmentOpenPreviewResponse>;
+    getPreviewClose(input: ApiParchmentClosePreviewBody): Promise<ApiParchmentClosePreviewResponse>;
+    getDepositTx(input: Omit<ApiParchmentDepositTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    getWithdrawTx(input: Omit<ApiParchmentWithdrawTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Two-step open request; the keeper fills it. */
+    getRequestOpenTx(input: Omit<ApiParchmentRequestOpenTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /**
+     * Delegate open request. No AccountCap. `walletAddress` is the delegate (the signer); it never
+     * defaults to the owner, since `account::assert_delegate` checks the sender's delegate entry.
+     */
+    getRequestOpenAsDelegateTx(input: Omit<ApiParchmentRequestOpenAsDelegateTxBody, "accountId"> & {
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Two-step close request; the keeper fills it. */
+    getRequestCloseTx(input: Omit<ApiParchmentRequestCloseTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Delegate close request. No AccountCap. */
+    getRequestCloseAsDelegateTx(input: Omit<ApiParchmentRequestCloseAsDelegateTxBody, "accountId"> & {
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Cancel a pending order after its cancel delay. */
+    getCancelOrderTx(input: Omit<ApiParchmentCancelOrderTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Delegate cancel. No AccountCap. */
+    getCancelOrderAsDelegateTx(input: Omit<ApiParchmentCancelOrderAsDelegateTxBody, "accountId"> & {
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Permissionless expiry, allowed after `orderExpiresAfterMs(order)`. */
+    getExpireOrderTx(input: Omit<ApiParchmentExpireOrderTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Emergency close of a pending close order after `emergencyAfterMs`. */
+    getEmergencyCloseTx(input: Omit<ApiParchmentEmergencyCloseTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Delegate emergency close. No AccountCap. */
+    getEmergencyCloseAsDelegateTx(input: Omit<ApiParchmentEmergencyCloseAsDelegateTxBody, "accountId"> & {
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /**
+     * Owner one-step close of this account's position on a retired market. Runs under every
+     * pause; aborts `trade::EOracleKilled` (20) only while the market's oracle kill switch is on.
+     */
+    getCloseRetiredTx(input: Omit<ApiParchmentCloseRetiredTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Delegate close on a retired market. No AccountCap. Same pause aborts as `getCloseRetiredTx`. */
+    getCloseRetiredAsDelegateTx(input: Omit<ApiParchmentCloseRetiredAsDelegateTxBody, "accountId"> & {
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /**
+     * Account-free liquidation of any crossed position; the bounty goes to this wallet. Order keepers only: any
+     * other sender aborts `trade::EKeeperOnlyLiquidation` (36). Runs under every pause; aborts
+     * `trade::EOracleKilled` (20) only under the market's kill switch (`liquidationPaused`).
+     */
+    getLiquidateTx(input: Omit<ApiParchmentLiquidateTxBody, "walletAddress"> & {
+        walletAddress?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Mint PARCHMENT against fee-mint basis parked by account-free liquidations of this account. */
+    getClaimPendingMintTx(input: Omit<ApiParchmentClaimPendingMintTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /**
+     * User-triggered FIFO crank. Credits the exchange-side free balance and does
+     * not transfer a coin to the wallet. `maxEntries` defaults to 32 and must be
+     * from 1 to 128. This call takes no account objects.
+     */
+    getHarvestTx(input?: Omit<ApiParchmentLpHarvestTxBody, "walletAddress"> & {
+        walletAddress?: string;
+    }): Promise<ParchmentBuiltTx>;
+    getBindReferrerTx(input: Omit<ApiParchmentBindReferrerTxBody, "walletAddress"> & {
+        walletAddress?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /**
+     * Bind a trading referrer for this account. Requires `accountCapId` and `referrer`.
+     * Version and digest are sent only when the caller provides them.
+     */
+    getBindTradingReferrerTx(input: Omit<ApiParchmentBindTradingReferrerTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Transfer this account to `recipient` in one step. Requires `accountCapId`. */
+    getTransferAccountTx(input: Omit<ApiParchmentTransferAccountTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    getStakeTx(input: Omit<ApiParchmentStakeTxBody, "walletAddress"> & {
+        walletAddress?: string;
+    }): Promise<ParchmentBuiltTx>;
+    getUnstakeTx(input: Omit<ApiParchmentUnstakeTxBody, "walletAddress"> & {
+        walletAddress?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Staking reward claim. The staker keeps 100%; a referred claim records the referrers' bonus as owed, paid from the treasury share. */
+    getClaimTx(input?: Omit<ApiParchmentClaimTxBody, "walletAddress"> & {
+        walletAddress?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** `release-unlocked` for this owner (or `who`): pays the vested locked PARCHMENT to its owner. */
+    getReleaseUnlockedTx(input?: Omit<ApiParchmentReleaseUnlockedTxBody, "walletAddress"> & {
+        walletAddress?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Vest `exit-early` for this owner. Unbounded across a bucket's unlock: see `Parchment.getExitEarlyTx`. */
+    getExitEarlyTx(input?: Omit<ApiParchmentExitEarlyTxBody, "walletAddress"> & {
+        walletAddress?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Vest `exit-early-bounded` for this owner: see `Parchment.getExitEarlyBoundedTx`. */
+    getExitEarlyBoundedTx(input: Omit<ApiParchmentExitEarlyBoundedTxBody, "walletAddress"> & {
+        walletAddress?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Delegate expiry uses the shared on-chain Clock (0x6); legacy `nowMs` is ignored. */
+    getGrantDelegateTx(input: Omit<ApiParchmentGrantDelegateTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    getRevokeDelegateTx(input: Omit<ApiParchmentRevokeDelegateTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Daily streak XP only; no coin result. Omits `questId`. Version and digest are sent only when provided. */
+    getClaimDailyTx(input: Omit<ApiParchmentGameTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** XP/cosmetic crate via a private entry MoveCall using on-chain randomness; no result. Omits `questId`. */
+    getOpenCrateTx(input: Omit<ApiParchmentGameTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /**
+     * Open `count` crates (at least 1, no app-level cap) in one private entry MoveCall using on-chain randomness; no
+     * result, one `CrateOpened` event per crate. `count` is checked locally (`count_required` / `bad_count`).
+     * The batch's tier-ups and XP crate grants are deferred to the player's next open or XP grant.
+     */
+    getOpenCratesTx(input: Omit<ApiParchmentOpenCratesTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Claim one quest for XP/cosmetics; no coin result. Version and digest are sent only when provided. */
+    getClaimQuestTx(input: Omit<ApiParchmentClaimQuestTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    /** Issue pending fee-backed achievement PARCHMENT using Clock and daily caps; returns a coin to transfer. */
+    getCollectMintTx(input: Omit<ApiParchmentGameTxBody, "walletAddress" | "accountId"> & {
+        walletAddress?: string;
+        accountId?: string;
+    }): Promise<ParchmentBuiltTx>;
+    private accountId;
+}

package/dist/packages/parchment/parchmentAccount.js

@@ -0,0 +1,273 @@
+import { equityRange, historyCursor, limitParam, normalizeAddress } from "../../general/utils/address.js";
+import { Caller } from "../../general/utils/caller.js";
+import { ParchmentApiError } from "../../general/utils/errors.js";
+import { PUBLIC_INTS } from "./publicInts.js";
+import { bindReferrerTxBody, bindTradingReferrerTxBody, transferAccountTxBody, claimQuestTxBody, claimTxBody, exitEarlyBoundedTxBody, exitEarlyTxBody, releaseUnlockedTxBody, closePreviewBody, cancelOrderTxBody, closeRetiredAsDelegateTxBody, closeRetiredTxBody, emergencyCloseAsDelegateTxBody, emergencyCloseTxBody, expireOrderTxBody, orderRefTxBody, requestCloseAsDelegateTxBody, requestCloseTxBody, requestOpenAsDelegateTxBody, requestOpenTxBody, depositTxBody, gameTxBody, openCratesTxBody, grantDelegateTxBody, liquidateTxBody, claimPendingMintTxBody, lpHarvestTxBody, openPreviewBody, revokeDelegateTxBody, stakeTxBody, unstakeTxBody, withdrawTxBody, } from "./txBodies.js";
+function query(pairs) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(pairs)) {
+        if (value !== undefined)
+            params.set(key, value);
+    }
+    const text = params.toString();
+    return text ? `?${text}` : "";
+}
+export class ParchmentAccount extends Caller {
+    account;
+    owner;
+    constructor(config, account) {
+        super(config, "parchment");
+        this.account = account;
+        this.owner = account.owner;
+    }
+    getPositions() {
+        return this.account.positions;
+    }
+    getQueue() {
+        return this.account.queue;
+    }
+    async refresh() {
+        const data = await this.fetchApi(`accounts/${normalizeAddress(this.owner)}`, PUBLIC_INTS.account);
+        return new ParchmentAccount(this.config, data);
+    }
+    async refreshPositions() {
+        return this.fetchApiField(`accounts/${normalizeAddress(this.owner)}/positions`, "positions", PUBLIC_INTS.positions);
+    }
+    async getHistory(input = {}) {
+        const qs = query({
+            cursor: historyCursor(input.cursor),
+            limit: limitParam(input.limit),
+        });
+        return this.fetchApi(`accounts/${normalizeAddress(this.owner)}/history${qs}`, PUBLIC_INTS.history);
+    }
+    async getEquityHistory(range) {
+        return this.fetchApi(`accounts/${normalizeAddress(this.owner)}/equity?range=${equityRange(range)}`, PUBLIC_INTS.equityHistory);
+    }
+    getPreviewOpen(input) {
+        const only = this.account.accounts.length === 1 ? this.account.accounts[0].accountId : undefined;
+        return this.fetchApi("previews/open", PUBLIC_INTS.previewOpen, openPreviewBody({ ...input, accountId: input.accountId ?? only }));
+    }
+    getPreviewClose(input) {
+        return this.fetchApi("previews/close", PUBLIC_INTS.previewClose, closePreviewBody(input));
+    }
+    async getDepositTx(input) {
+        return this.fetchApiTxObject("transactions/deposit", depositTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getWithdrawTx(input) {
+        return this.fetchApiTxObject("transactions/withdraw", withdrawTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getRequestOpenTx(input) {
+        return this.fetchApiTxObject("transactions/request-open", requestOpenTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getRequestOpenAsDelegateTx(input) {
+        return this.fetchApiTxObject("transactions/request-open-as-delegate", requestOpenAsDelegateTxBody({
+            ...input,
+            walletAddress: delegateSender(input.walletAddress),
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getRequestCloseTx(input) {
+        return this.fetchApiTxObject("transactions/request-close", requestCloseTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getRequestCloseAsDelegateTx(input) {
+        return this.fetchApiTxObject("transactions/request-close-as-delegate", requestCloseAsDelegateTxBody({
+            ...input,
+            walletAddress: delegateSender(input.walletAddress),
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getCancelOrderTx(input) {
+        return this.fetchApiTxObject("transactions/cancel-order", cancelOrderTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getCancelOrderAsDelegateTx(input) {
+        return this.fetchApiTxObject("transactions/cancel-order-as-delegate", orderRefTxBody({
+            ...input,
+            walletAddress: delegateSender(input.walletAddress),
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getExpireOrderTx(input) {
+        return this.fetchApiTxObject("transactions/expire-order", expireOrderTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getEmergencyCloseTx(input) {
+        return this.fetchApiTxObject("transactions/emergency-close", emergencyCloseTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getEmergencyCloseAsDelegateTx(input) {
+        return this.fetchApiTxObject("transactions/emergency-close-as-delegate", emergencyCloseAsDelegateTxBody({
+            ...input,
+            walletAddress: delegateSender(input.walletAddress),
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getCloseRetiredTx(input) {
+        return this.fetchApiTxObject("transactions/close-retired", closeRetiredTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getCloseRetiredAsDelegateTx(input) {
+        return this.fetchApiTxObject("transactions/close-retired-as-delegate", closeRetiredAsDelegateTxBody({
+            ...input,
+            walletAddress: delegateSender(input.walletAddress),
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getLiquidateTx(input) {
+        const path = input.retired ? "transactions/liquidate-retired" : "transactions/liquidate";
+        return this.fetchApiTxObject(path, liquidateTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+        }));
+    }
+    async getClaimPendingMintTx(input) {
+        return this.fetchApiTxObject("transactions/claim-pending-mint", claimPendingMintTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    getHarvestTx(input = {}) {
+        return this.fetchApiTxObject("transactions/harvest", lpHarvestTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+        }));
+    }
+    getBindReferrerTx(input) {
+        return this.fetchApiTxObject("transactions/bind-referrer", bindReferrerTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+        }));
+    }
+    async getBindTradingReferrerTx(input) {
+        return this.fetchApiTxObject("transactions/bind-trading-referrer", bindTradingReferrerTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getTransferAccountTx(input) {
+        return this.fetchApiTxObject("transactions/transfer-account", transferAccountTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    getStakeTx(input) {
+        return this.fetchApiTxObject("transactions/stake", stakeTxBody({ ...input, walletAddress: input.walletAddress ?? this.owner }));
+    }
+    getUnstakeTx(input) {
+        return this.fetchApiTxObject("transactions/unstake", unstakeTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+        }));
+    }
+    getClaimTx(input = {}) {
+        return this.fetchApiTxObject("transactions/claim", claimTxBody({ walletAddress: input.walletAddress ?? this.owner, shared: input.shared }));
+    }
+    async getReleaseUnlockedTx(input = {}) {
+        const walletAddress = input.walletAddress ?? this.owner;
+        const built = await this.fetchApiTxObject("transactions/release-unlocked", releaseUnlockedTxBody({ ...input, walletAddress }));
+        return input.syncLocked ? this.appendSyncLocked(built, input.who ?? walletAddress) : built;
+    }
+    async getExitEarlyTx(input = {}) {
+        const walletAddress = input.walletAddress ?? this.owner;
+        const built = await this.fetchApiTxObject("transactions/exit-early", exitEarlyTxBody({ ...input, walletAddress }));
+        return input.syncLocked ? this.appendSyncLocked(built, walletAddress) : built;
+    }
+    async getExitEarlyBoundedTx(input) {
+        const walletAddress = input.walletAddress ?? this.owner;
+        const built = await this.fetchApiTxObject("transactions/exit-early-bounded", exitEarlyBoundedTxBody({ ...input, walletAddress }));
+        return input.syncLocked ? this.appendSyncLocked(built, walletAddress) : built;
+    }
+    async getGrantDelegateTx(input) {
+        return this.fetchApiTxObject("transactions/grant-delegate", grantDelegateTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getRevokeDelegateTx(input) {
+        return this.fetchApiTxObject("transactions/revoke-delegate", revokeDelegateTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getClaimDailyTx(input) {
+        return this.fetchApiTxObject("transactions/claim-daily", gameTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getOpenCrateTx(input) {
+        return this.fetchApiTxObject("transactions/open-crate", gameTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getOpenCratesTx(input) {
+        return this.fetchApiTxObject("transactions/open-crates", openCratesTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getClaimQuestTx(input) {
+        return this.fetchApiTxObject("transactions/claim-quest", claimQuestTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    async getCollectMintTx(input) {
+        return this.fetchApiTxObject("transactions/collect-mint", gameTxBody({
+            ...input,
+            walletAddress: input.walletAddress ?? this.owner,
+            accountId: this.accountId(input.accountId),
+        }));
+    }
+    accountId(explicit) {
+        if (explicit)
+            return normalizeAddress(explicit);
+        if (this.account.accounts.length === 1)
+            return this.account.accounts[0].accountId;
+        throw new ParchmentApiError(0, "account_id_required", "accountId is required when this owner does not have exactly one account");
+    }
+}
+function delegateSender(walletAddress) {
+    if (!walletAddress) {
+        throw new Error("as-delegate txs need walletAddress: the delegate's wallet, not the account owner");
+    }
+    return walletAddress;
+}

package/dist/packages/parchment/parchmentMarket.d.ts

@@ -0,0 +1,58 @@
+import type { CallerConfig } from "../../general/types/configTypes.js";
+import { Caller } from "../../general/utils/caller.js";
+import type { ApiParchmentOpenPreviewBody, ApiParchmentOpenPreviewResponse, ApiParchmentPriceHistoryBody, ApiParchmentPriceHistoryResponse, ParchmentMarketView, ParchmentPrice } from "./parchmentTypes.js";
+/** `constants::status_active()`: opens and closes allowed. */
+export declare const MARKET_STATUS_ACTIVE = 1n;
+/**
+ * `constants::status_reduce_only()`: `request_open` aborts `order::ERequestsPaused` (15) and a pending
+ * open filled after the change refunds outcome 7 (`closed`); closes still go through. (One-step
+ * `open` aborts `trade::EMarketNotActive`.)
+ */
+export declare const MARKET_STATUS_REDUCE_ONLY = 2n;
+/** `constants::status_retired()`: exit with `close_retired` / `liquidate_retired`; emergency close aborts `EMarketNotActive`. */
+export declare const MARKET_STATUS_RETIRED = 3n;
+/**
+ * The market's `TimingParamsV1.min_hold_ms` as a number, or null when the service has not indexed
+ * timing params (or the value is past `Number.MAX_SAFE_INTEGER`).
+ */
+export declare function marketMinHoldMs(market: Pick<ParchmentMarketView, "timing">): number | null;
+/** Served `sessionEndsAtMs` as a number; null when absent. */
+export declare function marketSessionEndsAtMs(market: Pick<ParchmentMarketView, "sessionEndsAtMs">): number | null;
+/** Served `nextSessionOpenMs` as a number; null when absent. */
+export declare function marketNextSessionOpenMs(market: Pick<ParchmentMarketView, "nextSessionOpenMs">): number | null;
+/** True when `status` is `MARKET_STATUS_RETIRED`. False for unindexed (null) status. */
+export declare function marketIsRetired(market: Pick<ParchmentMarketView, "status">): boolean;
+/** True when the service flags the market `delisted` (missing from the Registry's `market_ids`). False when absent. */
+export declare function marketIsDelisted(market: Pick<ParchmentMarketView, "delisted">): boolean;
+/** True when `status` is `MARKET_STATUS_ACTIVE`. False for unindexed (null) status. */
+export declare function marketIsActive(market: Pick<ParchmentMarketView, "status">): boolean;
+/**
+ * Cause-specific copy for `order::ERequestsPaused` (15), which `request_open` / `request_close` raise
+ * for several causes, from market state the caller already has (no fetch, no new fields). Checks, in
+ * order: retired (opens and closes; exit with close-retired, which runs under every pause and stops only while
+ * the market's oracle is off), oracle off, reduce-only (opens only).
+ * Anything else (a paused market or exchange, a disabled market, unindexed state, no `action`) gets the
+ * generic `ORDER_ABORT_MESSAGES.ERequestsPaused`. The market view can lag the chain, so this is copy
+ * only: never use it to decide whether to send.
+ */
+export declare function requestsPausedMessage(market: Pick<ParchmentMarketView, "status" | "oracleKilled"> | null | undefined, action?: "open" | "close"): string;
+/**
+ * True when liquidation is stopped on this market by state the caller already has.
+ * `liquidate`, `liquidate-retired` and `sweep` run under every pause, including `pause_all` and the exchange or
+ * market close pause; only the market's oracle kill switch stops them (`trade::EOracleKilled` 20). Reads the
+ * market's `oracleKilled` and the served `liquidationPaused` (which is the same kill switch). Unindexed (null) or
+ * missing flags count as not paused. Views can lag the chain, so use this for copy and to skip pointless sends,
+ * not as a guarantee; price freshness and validity still decide on chain.
+ */
+export declare function liquidationPaused(market: (Pick<ParchmentMarketView, "oracleKilled"> & {
+    liquidationPaused?: boolean | null;
+}) | null | undefined): boolean;
+/** Market view plus reads. Does not read a storage object itself. */
+export declare class ParchmentMarket extends Caller {
+    readonly market: ParchmentMarketView;
+    constructor(config: CallerConfig, market: ParchmentMarketView);
+    get price(): ParchmentPrice;
+    refresh(): Promise<ParchmentMarket>;
+    getPriceHistory(input?: Omit<ApiParchmentPriceHistoryBody, "marketId">): Promise<ApiParchmentPriceHistoryResponse>;
+    getPreviewOpen(input: Omit<ApiParchmentOpenPreviewBody, "marketId">): Promise<ApiParchmentOpenPreviewResponse>;
+}

package/dist/packages/parchment/parchmentMarket.js

@@ -0,0 +1,86 @@
+import { ORDER_ABORT_MESSAGES } from "./abortCodes.js";
+import { i64Ms, limitParam, normalizeAddress } from "../../general/utils/address.js";
+import { Caller } from "../../general/utils/caller.js";
+import { PUBLIC_INTS } from "./publicInts.js";
+import { openPreviewBody } from "./txBodies.js";
+function query(pairs) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(pairs)) {
+        if (value !== undefined)
+            params.set(key, value);
+    }
+    const text = params.toString();
+    return text ? `?${text}` : "";
+}
+export const MARKET_STATUS_ACTIVE = 1n;
+export const MARKET_STATUS_REDUCE_ONLY = 2n;
+export const MARKET_STATUS_RETIRED = 3n;
+export function marketMinHoldMs(market) {
+    return msOrNull(market.timing?.minHoldMs);
+}
+function msOrNull(raw) {
+    if (raw === null || raw === undefined || raw < 0n || raw > BigInt(Number.MAX_SAFE_INTEGER))
+        return null;
+    return Number(raw);
+}
+export function marketSessionEndsAtMs(market) {
+    return msOrNull(market.sessionEndsAtMs);
+}
+export function marketNextSessionOpenMs(market) {
+    return msOrNull(market.nextSessionOpenMs);
+}
+export function marketIsRetired(market) {
+    return market.status === MARKET_STATUS_RETIRED;
+}
+export function marketIsDelisted(market) {
+    return market.delisted === true;
+}
+export function marketIsActive(market) {
+    return market.status === MARKET_STATUS_ACTIVE;
+}
+export function requestsPausedMessage(market, action) {
+    const generic = ORDER_ABORT_MESSAGES.ERequestsPaused;
+    if (!market || (action !== "open" && action !== "close"))
+        return generic;
+    if (market.status === MARKET_STATUS_RETIRED) {
+        if (market.oracleKilled === true) {
+            return "This market is retired and its price feed is off; positions can exit with close-retired once it is back";
+        }
+        return "This market is retired; close positions with close-retired";
+    }
+    if (market.oracleKilled === true) {
+        return "This market's price feed (oracle) is off; orders are not accepted until it is back";
+    }
+    if (market.status === MARKET_STATUS_REDUCE_ONLY && action === "open") {
+        return "This market is reduce-only: you can close positions but not open new ones";
+    }
+    return generic;
+}
+export function liquidationPaused(market) {
+    return market?.liquidationPaused === true || market?.oracleKilled === true;
+}
+export class ParchmentMarket extends Caller {
+    market;
+    constructor(config, market) {
+        super(config, "parchment");
+        this.market = market;
+    }
+    get price() {
+        return this.market.price;
+    }
+    async refresh() {
+        const market = await this.fetchApiField(`markets/${normalizeAddress(this.market.marketId)}`, "market", PUBLIC_INTS.market);
+        return new ParchmentMarket(this.config, market);
+    }
+    async getPriceHistory(input = {}) {
+        const qs = query({
+            fromMs: input.fromMs === undefined ? undefined : i64Ms(input.fromMs, "fromMs"),
+            toMs: input.toMs === undefined ? undefined : i64Ms(input.toMs, "toMs"),
+            limit: limitParam(input.limit),
+        });
+        return this.fetchApi(`markets/${normalizeAddress(this.market.marketId)}/prices${qs}`, PUBLIC_INTS.priceHistory);
+    }
+    getPreviewOpen(input) {
+        return this.fetchApi("previews/open", PUBLIC_INTS.previewOpen, openPreviewBody({ ...input, marketId: this.market.marketId }));
+    }
+}