@kehtus/proportion-sdk 0.5.0 → 1.2.0

package/dist/challenge/intents.js

@@ -0,0 +1,218 @@
+import { hashTypedData, recoverTypedDataAddress, } from "viem";
+import { challengeAccountAbi } from "../abi/challengeAccount.js";
+// EIP-712 types mirroring ChallengeAccount's typehashes:
+//   OpenIntent(address owner,address account,uint32 market,bool isLong,uint96 margin,
+//              uint96 notional,uint64 maxPrice,uint64 minPrice,uint256 nonce,uint64 deadline)
+//   CloseIntent(address owner,address account,uint64 positionId,uint64 maxPrice,
+//               uint64 minPrice,uint256 nonce,uint64 deadline)
+export const OPEN_INTENT_TYPES = {
+    OpenIntent: [
+        { name: "owner", type: "address" },
+        { name: "account", type: "address" },
+        { name: "market", type: "uint32" },
+        { name: "isLong", type: "bool" },
+        { name: "margin", type: "uint96" },
+        { name: "notional", type: "uint96" },
+        { name: "maxPrice", type: "uint64" },
+        { name: "minPrice", type: "uint64" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint64" },
+    ],
+};
+export const CLOSE_INTENT_TYPES = {
+    CloseIntent: [
+        { name: "owner", type: "address" },
+        { name: "account", type: "address" },
+        { name: "positionId", type: "uint64" },
+        { name: "maxPrice", type: "uint64" },
+        { name: "minPrice", type: "uint64" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint64" },
+    ],
+};
+/** SessionKeyLib permission bits (bitmask for registerSessionKey / SessionKey.permissions). */
+export const SESSION_PERMISSION_OPEN = 1n << 0n;
+export const SESSION_PERMISSION_CLOSE = 1n << 1n;
+const DEFAULT_INTENT_TTL_SECONDS = 600;
+/**
+ * EIP-712 domain of a ChallengeAccount clone. The domain is bound to the clone address,
+ * so intents can never replay across accounts or chains.
+ */
+export function challengeAccountDomain(account, chainId) {
+    return {
+        name: "ProportionChallengeAccount",
+        version: "1",
+        chainId,
+        verifyingContract: account,
+    };
+}
+/** Local EIP-712 digest of an open intent (matches ChallengeAccount's on-chain digest). */
+export function hashOpenIntent(intent, chainId) {
+    return hashTypedData({
+        domain: challengeAccountDomain(intent.account, chainId),
+        types: OPEN_INTENT_TYPES,
+        primaryType: "OpenIntent",
+        message: intent,
+    });
+}
+/** Local EIP-712 digest of a close intent (matches ChallengeAccount's on-chain digest). */
+export function hashCloseIntent(intent, chainId) {
+    return hashTypedData({
+        domain: challengeAccountDomain(intent.account, chainId),
+        types: CLOSE_INTENT_TYPES,
+        primaryType: "CloseIntent",
+        message: intent,
+    });
+}
+/**
+ * Symmetric slippage bounds around an oracle price for intent maxPrice/minPrice.
+ * The contract checks the fill against both bounds, so setting both is safe for
+ * either side. Prices are raw HyperCore uint64 units.
+ */
+export function priceBounds(price, slippageBps) {
+    if (slippageBps < 0 || slippageBps > 10_000)
+        throw new Error("slippageBps out of range [0, 10000]");
+    const bps = BigInt(slippageBps);
+    return {
+        maxPrice: (price * (10000n + bps)) / 10000n,
+        minPrice: (price * (10000n - bps)) / 10000n,
+    };
+}
+/**
+ * Session-key market whitelist: bit `market` set = allowed. Markets must be < 256.
+ *
+ * CAUTION: on-chain a mask of 0 means ALL markets allowed (SessionKeyLib treats 0 as
+ * "no restriction"), which is the opposite of an empty whitelist — so an empty input
+ * throws instead of silently producing the most permissive value. To deliberately allow
+ * all markets, pass 0n to registerSessionKey directly.
+ */
+export function marketsToMask(markets) {
+    if (markets.length === 0) {
+        throw new Error("empty market list; on-chain mask 0 = ALL markets — pass 0n explicitly to allow all");
+    }
+    let mask = 0n;
+    for (const market of markets) {
+        if (!Number.isInteger(market) || market < 0 || market > 255) {
+            throw new Error(`market ${market} out of mask range [0, 255]`);
+        }
+        mask |= 1n << BigInt(market);
+    }
+    return mask;
+}
+export function maskToMarkets(mask) {
+    const markets = [];
+    for (let i = 0; i < 256; i++) {
+        if ((mask >> BigInt(i)) & 1n)
+            markets.push(i);
+    }
+    return markets;
+}
+/**
+ * Builds and signs ChallengeAccount trade intents (EIP-712). This is the canonical gasless
+ * trading path: the owner or a registered session key signs the intent locally and the
+ * challenge-service relayer submits it via openPositionBySig/closePositionBySig
+ * (see ChallengeApiClient.submitOpenIntent / submitCloseIntent).
+ */
+export class ChallengeIntentsModule {
+    publicClient;
+    walletClient;
+    chain;
+    constructor(publicClient, walletClient, chain) {
+        this.publicClient = publicClient;
+        this.walletClient = walletClient;
+        this.chain = chain;
+    }
+    requireWallet() {
+        if (!this.walletClient)
+            throw new Error("WalletClient required for signing");
+        const walletChainId = this.walletClient.chain?.id;
+        if (walletChainId !== undefined && walletChainId !== this.chain.id) {
+            throw new Error(`WalletClient chain mismatch: expected ${this.chain.id}, got ${walletChainId}`);
+        }
+        return this.walletClient;
+    }
+    /** Next intent nonce of an account (monotonic; consumed by every bySig call). */
+    async getNonce(account) {
+        return this.publicClient.readContract({
+            address: account,
+            abi: challengeAccountAbi,
+            functionName: "nextNonce",
+        });
+    }
+    /**
+     * Sign an open intent. `owner` must be the account owner; it defaults to the signer,
+     * which is only correct when the owner (not a session key) signs. Session keys must
+     * pass the owner explicitly. `nonce` is fetched from the account when omitted.
+     */
+    async signOpenIntent(p) {
+        const wallet = this.requireWallet();
+        const signer = wallet.account;
+        if (!signer)
+            throw new Error("WalletClient has no account");
+        const intent = {
+            owner: p.owner ?? signer.address,
+            account: p.account,
+            market: p.market,
+            isLong: p.isLong,
+            margin: p.margin,
+            notional: p.notional,
+            maxPrice: p.maxPrice,
+            minPrice: p.minPrice,
+            nonce: p.nonce ?? (await this.getNonce(p.account)),
+            deadline: BigInt(p.deadlineSeconds ?? Math.floor(Date.now() / 1000) + DEFAULT_INTENT_TTL_SECONDS),
+        };
+        const signature = await wallet.signTypedData({
+            account: signer,
+            domain: challengeAccountDomain(p.account, this.chain.id),
+            types: OPEN_INTENT_TYPES,
+            primaryType: "OpenIntent",
+            message: intent,
+        });
+        return { intent, signature };
+    }
+    /** Sign a close intent. Same owner/nonce semantics as signOpenIntent. */
+    async signCloseIntent(p) {
+        const wallet = this.requireWallet();
+        const signer = wallet.account;
+        if (!signer)
+            throw new Error("WalletClient has no account");
+        const intent = {
+            owner: p.owner ?? signer.address,
+            account: p.account,
+            positionId: p.positionId,
+            maxPrice: p.maxPrice,
+            minPrice: p.minPrice,
+            nonce: p.nonce ?? (await this.getNonce(p.account)),
+            deadline: BigInt(p.deadlineSeconds ?? Math.floor(Date.now() / 1000) + DEFAULT_INTENT_TTL_SECONDS),
+        };
+        const signature = await wallet.signTypedData({
+            account: signer,
+            domain: challengeAccountDomain(p.account, this.chain.id),
+            types: CLOSE_INTENT_TYPES,
+            primaryType: "CloseIntent",
+            message: intent,
+        });
+        return { intent, signature };
+    }
+    /** Recover the signer of a signed open intent (owner or session key). */
+    async recoverOpenIntentSigner(signed) {
+        return recoverTypedDataAddress({
+            domain: challengeAccountDomain(signed.intent.account, this.chain.id),
+            types: OPEN_INTENT_TYPES,
+            primaryType: "OpenIntent",
+            message: signed.intent,
+            signature: signed.signature,
+        });
+    }
+    /** Recover the signer of a signed close intent (owner or session key). */
+    async recoverCloseIntentSigner(signed) {
+        return recoverTypedDataAddress({
+            domain: challengeAccountDomain(signed.intent.account, this.chain.id),
+            types: CLOSE_INTENT_TYPES,
+            primaryType: "CloseIntent",
+            message: signed.intent,
+            signature: signed.signature,
+        });
+    }
+}
+//# sourceMappingURL=intents.js.map

package/dist/challenge/intents.js.map

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

package/dist/challenge/oracle.d.ts

@@ -0,0 +1,50 @@
+import type { Address, PublicClient } from "viem";
+import type { OracleMarketState } from "./types.js";
+type AddressResolver = Address | (() => Promise<Address>);
+/**
+ * Read-only PriceOracle module (HyperCore BBO/mark). Used by frontends for price display
+ * and for deriving intent maxPrice/minPrice bounds (see priceBounds in intents.ts).
+ * All prices are raw HyperCore uint64 units.
+ *
+ * Owner controls (freeze/settle/pause/config) are multisig territory; refreshMarket is a
+ * keeper duty of the challenge-service — both intentionally not covered.
+ */
+export declare class ChallengePricesModule {
+    private publicClient;
+    private addressResolver;
+    private addressPromise;
+    constructor(publicClient: PublicClient, addressResolver: AddressResolver);
+    /**
+     * Resolved PriceOracle address (lazy when constructed with a resolver). The in-flight
+     * promise is shared by concurrent callers (one RPC lookup); failures clear it for retry.
+     */
+    getAddress(): Promise<Address>;
+    /** Live best bid/offer for a market. */
+    getBbo(market: number): Promise<{
+        bid: bigint;
+        ask: bigint;
+    }>;
+    /**
+     * Taker-side execution price. isOpen=true uses the live BBO and reverts on
+     * disabled/paused/settled/frozen/stale markets; isOpen=false (close) is always allowed
+     * and clamped conservatively.
+     */
+    getExecutionPrice(market: number, isLong: boolean, isOpen: boolean): Promise<bigint>;
+    /** Conservative mark price used for valuation/liquidation (never trader-favorable). */
+    getRiskPrice(market: number, isLong: boolean): Promise<bigint>;
+    /** Batch price read for many markets (risk=true → risk prices, else mid/mark path). */
+    getPrices(markets: number[], risk: boolean): Promise<bigint[]>;
+    /** Per-market oracle cache/override state (frozen book, settled price, lastGoodMark age). */
+    getMarketState(market: number): Promise<OracleMarketState>;
+    /** Global oracle guard-rails (spread/deviation/staleness bounds) + pause flag. */
+    getConfig(): Promise<{
+        maxSpreadBps: number;
+        maxMarkDeviationBps: number;
+        fallbackSpreadBps: number;
+        maxStaleness: number;
+        paused: boolean;
+        owner: Address;
+    }>;
+}
+export {};
+//# sourceMappingURL=oracle.d.ts.map

package/dist/challenge/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/challenge/oracle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAGlD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,KAAK,eAAe,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAE1D;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAI9B,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,eAAe;IAJzB,OAAO,CAAC,cAAc,CAA+B;gBAG3C,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,eAAe;IAK1C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAWpC,wCAAwC;IAClC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAWnE;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAU1F,uFAAuF;IACjF,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpE,uFAAuF;IACjF,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWpE,6FAA6F;IACvF,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAYhE,kFAAkF;IAC5E,SAAS,IAAI,OAAO,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;CAuBH"}

package/dist/challenge/oracle.js

@@ -0,0 +1,117 @@
+import { priceOracleAbi } from "../abi/priceOracle.js";
+import { assertAllSuccess } from "../utils.js";
+/**
+ * Read-only PriceOracle module (HyperCore BBO/mark). Used by frontends for price display
+ * and for deriving intent maxPrice/minPrice bounds (see priceBounds in intents.ts).
+ * All prices are raw HyperCore uint64 units.
+ *
+ * Owner controls (freeze/settle/pause/config) are multisig territory; refreshMarket is a
+ * keeper duty of the challenge-service — both intentionally not covered.
+ */
+export class ChallengePricesModule {
+    publicClient;
+    addressResolver;
+    addressPromise;
+    constructor(publicClient, addressResolver) {
+        this.publicClient = publicClient;
+        this.addressResolver = addressResolver;
+        if (typeof addressResolver === "string")
+            this.addressPromise = Promise.resolve(addressResolver);
+    }
+    /**
+     * Resolved PriceOracle address (lazy when constructed with a resolver). The in-flight
+     * promise is shared by concurrent callers (one RPC lookup); failures clear it for retry.
+     */
+    async getAddress() {
+        if (!this.addressPromise) {
+            const resolver = this.addressResolver;
+            this.addressPromise = resolver().catch((err) => {
+                this.addressPromise = undefined;
+                throw err;
+            });
+        }
+        return this.addressPromise;
+    }
+    /** Live best bid/offer for a market. */
+    async getBbo(market) {
+        const address = await this.getAddress();
+        const [bid, ask] = await this.publicClient.readContract({
+            address,
+            abi: priceOracleAbi,
+            functionName: "getBbo",
+            args: [market],
+        });
+        return { bid, ask };
+    }
+    /**
+     * Taker-side execution price. isOpen=true uses the live BBO and reverts on
+     * disabled/paused/settled/frozen/stale markets; isOpen=false (close) is always allowed
+     * and clamped conservatively.
+     */
+    async getExecutionPrice(market, isLong, isOpen) {
+        const address = await this.getAddress();
+        return this.publicClient.readContract({
+            address,
+            abi: priceOracleAbi,
+            functionName: "getExecutionPrice",
+            args: [market, isLong, isOpen],
+        });
+    }
+    /** Conservative mark price used for valuation/liquidation (never trader-favorable). */
+    async getRiskPrice(market, isLong) {
+        const address = await this.getAddress();
+        return this.publicClient.readContract({
+            address,
+            abi: priceOracleAbi,
+            functionName: "getRiskPrice",
+            args: [market, isLong],
+        });
+    }
+    /** Batch price read for many markets (risk=true → risk prices, else mid/mark path). */
+    async getPrices(markets, risk) {
+        const address = await this.getAddress();
+        const prices = await this.publicClient.readContract({
+            address,
+            abi: priceOracleAbi,
+            functionName: "getPrices",
+            args: [markets, risk],
+        });
+        return [...prices];
+    }
+    /** Per-market oracle cache/override state (frozen book, settled price, lastGoodMark age). */
+    async getMarketState(market) {
+        const address = await this.getAddress();
+        const [lastGoodMark, lastGoodAt, frozenBid, frozenAsk, settledPrice, frozen, settled] = await this.publicClient.readContract({
+            address,
+            abi: priceOracleAbi,
+            functionName: "markets",
+            args: [market],
+        });
+        return { lastGoodMark, lastGoodAt, frozenBid, frozenAsk, settledPrice, frozen, settled };
+    }
+    /** Global oracle guard-rails (spread/deviation/staleness bounds) + pause flag. */
+    async getConfig() {
+        const address = await this.getAddress();
+        const contract = { address, abi: priceOracleAbi };
+        const results = await this.publicClient.multicall({
+            contracts: [
+                { ...contract, functionName: "maxSpreadBps" },
+                { ...contract, functionName: "maxMarkDeviationBps" },
+                { ...contract, functionName: "fallbackSpreadBps" },
+                { ...contract, functionName: "maxStaleness" },
+                { ...contract, functionName: "paused" },
+                { ...contract, functionName: "owner" },
+            ],
+        });
+        const r = assertAllSuccess(results);
+        return {
+            maxSpreadBps: r[0],
+            maxMarkDeviationBps: r[1],
+            fallbackSpreadBps: r[2],
+            maxStaleness: r[3],
+            paused: r[4],
+            owner: r[5],
+        };
+    }
+}
+//# sourceMappingURL=oracle.js.map

package/dist/challenge/oracle.js.map

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