@acta-markets/ts-sdk 0.0.19-beta → 0.0.20-beta

package/dist/generated/instructions/updateOraclePrice.d.ts

@@ -5,14 +5,13 @@
  *
  * @see https://github.com/codama-idl/codama
  */
-import { type AccountMeta, type AccountSignerMeta, type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder, type Instruction, type InstructionWithAccounts, type InstructionWithData, type ReadonlyAccount, type ReadonlySignerAccount, type ReadonlyUint8Array, type TransactionSigner, type WritableAccount } from "@solana/kit";
+import { type AccountMeta, type AccountSignerMeta, type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder, type Instruction, type InstructionWithAccounts, type InstructionWithData, type ReadonlySignerAccount, type ReadonlyUint8Array, type TransactionSigner, type WritableAccount } from "@solana/kit";
 import { ACTA_CONTRACT_PROGRAM_ADDRESS } from "../programs";
 export declare const UPDATE_ORACLE_PRICE_DISCRIMINATOR = 16;
 export declare function getUpdateOraclePriceDiscriminatorBytes(): ReadonlyUint8Array;
-export type UpdateOraclePriceInstruction<TProgram extends string = typeof ACTA_CONTRACT_PROGRAM_ADDRESS, TAccountAuthority extends string | AccountMeta<string> = string, TAccountOraclePda extends string | AccountMeta<string> = string, TAccountClockSysvar extends string | AccountMeta<string> = "SysvarC1ock11111111111111111111111111111111", TRemainingAccounts extends readonly AccountMeta<string>[] = []> = Instruction<TProgram> & InstructionWithData<ReadonlyUint8Array> & InstructionWithAccounts<[
+export type UpdateOraclePriceInstruction<TProgram extends string = typeof ACTA_CONTRACT_PROGRAM_ADDRESS, TAccountAuthority extends string | AccountMeta<string> = string, TAccountOraclePda extends string | AccountMeta<string> = string, TRemainingAccounts extends readonly AccountMeta<string>[] = []> = Instruction<TProgram> & InstructionWithData<ReadonlyUint8Array> & InstructionWithAccounts<[
     TAccountAuthority extends string ? ReadonlySignerAccount<TAccountAuthority> & AccountSignerMeta<TAccountAuthority> : TAccountAuthority,
     TAccountOraclePda extends string ? WritableAccount<TAccountOraclePda> : TAccountOraclePda,
-    TAccountClockSysvar extends string ? ReadonlyAccount<TAccountClockSysvar> : TAccountClockSysvar,
     ...TRemainingAccounts
 ]>;
 export type UpdateOraclePriceInstructionData = {
@@ -27,19 +26,17 @@ export type UpdateOraclePriceInstructionDataArgs = {
 export declare function getUpdateOraclePriceInstructionDataEncoder(): FixedSizeEncoder<UpdateOraclePriceInstructionDataArgs>;
 export declare function getUpdateOraclePriceInstructionDataDecoder(): FixedSizeDecoder<UpdateOraclePriceInstructionData>;
 export declare function getUpdateOraclePriceInstructionDataCodec(): FixedSizeCodec<UpdateOraclePriceInstructionDataArgs, UpdateOraclePriceInstructionData>;
-export type UpdateOraclePriceInput<TAccountAuthority extends string = string, TAccountOraclePda extends string = string, TAccountClockSysvar extends string = string> = {
+export type UpdateOraclePriceInput<TAccountAuthority extends string = string, TAccountOraclePda extends string = string> = {
     /** Oracle authority signer (or protocol admin) */
     authority: TransactionSigner<TAccountAuthority>;
     /** Oracle PDA to update */
     oraclePda: Address<TAccountOraclePda>;
-    /** Clock sysvar account */
-    clockSysvar?: Address<TAccountClockSysvar>;
     price: UpdateOraclePriceInstructionDataArgs["price"];
     settledExpiryTs: UpdateOraclePriceInstructionDataArgs["settledExpiryTs"];
 };
-export declare function getUpdateOraclePriceInstruction<TAccountAuthority extends string, TAccountOraclePda extends string, TAccountClockSysvar extends string, TProgramAddress extends Address = typeof ACTA_CONTRACT_PROGRAM_ADDRESS>(input: UpdateOraclePriceInput<TAccountAuthority, TAccountOraclePda, TAccountClockSysvar>, config?: {
+export declare function getUpdateOraclePriceInstruction<TAccountAuthority extends string, TAccountOraclePda extends string, TProgramAddress extends Address = typeof ACTA_CONTRACT_PROGRAM_ADDRESS>(input: UpdateOraclePriceInput<TAccountAuthority, TAccountOraclePda>, config?: {
     programAddress?: TProgramAddress;
-}): UpdateOraclePriceInstruction<TProgramAddress, TAccountAuthority, TAccountOraclePda, TAccountClockSysvar>;
+}): UpdateOraclePriceInstruction<TProgramAddress, TAccountAuthority, TAccountOraclePda>;
 export type ParsedUpdateOraclePriceInstruction<TProgram extends string = typeof ACTA_CONTRACT_PROGRAM_ADDRESS, TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[]> = {
     programAddress: Address<TProgram>;
     accounts: {
@@ -47,8 +44,6 @@ export type ParsedUpdateOraclePriceInstruction<TProgram extends string = typeof
         authority: TAccountMetas[0];
         /** Oracle PDA to update */
         oraclePda: TAccountMetas[1];
-        /** Clock sysvar account */
-        clockSysvar: TAccountMetas[2];
     };
     data: UpdateOraclePriceInstructionData;
 };

package/dist/generated/instructions/updateOraclePrice.js

@@ -36,29 +36,22 @@ export function getUpdateOraclePriceInstruction(input, config) {
     const originalAccounts = {
         authority: { value: input.authority ?? null, isWritable: false },
         oraclePda: { value: input.oraclePda ?? null, isWritable: true },
-        clockSysvar: { value: input.clockSysvar ?? null, isWritable: false },
     };
     const accounts = originalAccounts;
     // Original args.
     const args = { ...input };
-    // Resolve default values.
-    if (!accounts.clockSysvar.value) {
-        accounts.clockSysvar.value =
-            "SysvarC1ock11111111111111111111111111111111";
-    }
     const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
     return Object.freeze({
         accounts: [
             getAccountMeta(accounts.authority),
             getAccountMeta(accounts.oraclePda),
-            getAccountMeta(accounts.clockSysvar),
         ],
         data: getUpdateOraclePriceInstructionDataEncoder().encode(args),
         programAddress,
     });
 }
 export function parseUpdateOraclePriceInstruction(instruction) {
-    if (instruction.accounts.length < 3) {
+    if (instruction.accounts.length < 2) {
         // TODO: Coded error.
         throw new Error("Not enough accounts");
     }
@@ -70,11 +63,7 @@ export function parseUpdateOraclePriceInstruction(instruction) {
     };
     return {
         programAddress: instruction.programAddress,
-        accounts: {
-            authority: getNextAccount(),
-            oraclePda: getNextAccount(),
-            clockSysvar: getNextAccount(),
-        },
+        accounts: { authority: getNextAccount(), oraclePda: getNextAccount() },
         data: getUpdateOraclePriceInstructionDataDecoder().decode(instruction.data),
     };
 }

package/dist/idl/acta_contract.json

@@ -344,7 +344,7 @@
                     "isMut": false,
                     "isSigner": false,
                     "docs": [
-                        "Underlying SPL mint"
+                        "Underlying SPL mint (used for PDA seed and decimals)"
                     ]
                 },
                 {
@@ -352,23 +352,7 @@
                     "isMut": false,
                     "isSigner": false,
                     "docs": [
-                        "Quote SPL mint"
-                    ]
-                },
-                {
-                    "name": "underlyingMintAcc",
-                    "isMut": false,
-                    "isSigner": false,
-                    "docs": [
-                        "Underlying mint account (for decimals)"
-                    ]
-                },
-                {
-                    "name": "quoteMintAcc",
-                    "isMut": false,
-                    "isSigner": false,
-                    "docs": [
-                        "Quote mint account (for decimals)"
+                        "Quote SPL mint (used for PDA seed and decimals)"
                     ]
                 },
                 {
@@ -617,14 +601,6 @@
                     "docs": [
                         "Quote oracle PDA"
                     ]
-                },
-                {
-                    "name": "clockSysvar",
-                    "isMut": false,
-                    "isSigner": false,
-                    "docs": [
-                        "Clock sysvar account"
-                    ]
                 }
             ],
             "args": [],
@@ -685,19 +661,11 @@
                     ]
                 },
                 {
-                    "name": "underlyingTokenProgram",
-                    "isMut": false,
-                    "isSigner": false,
-                    "docs": [
-                        "Token program for underlying mint"
-                    ]
-                },
-                {
-                    "name": "quoteTokenProgram",
+                    "name": "settlementTokenProgram",
                     "isMut": false,
                     "isSigner": false,
                     "docs": [
-                        "Token program for quote mint"
+                        "Token program for the settlement mint"
                     ]
                 }
             ],
@@ -1063,15 +1031,7 @@
                     "isMut": false,
                     "isSigner": false,
                     "docs": [
-                        "SPL mint this oracle prices"
-                    ]
-                },
-                {
-                    "name": "mintAcc",
-                    "isMut": false,
-                    "isSigner": false,
-                    "docs": [
-                        "Mint account (for decimals + token program owner)"
+                        "SPL mint this oracle prices (also used for decimals + token program owner)"
                     ]
                 },
                 {
@@ -1129,14 +1089,6 @@
                     "docs": [
                         "Oracle PDA to update"
                     ]
-                },
-                {
-                    "name": "clockSysvar",
-                    "isMut": false,
-                    "isSigner": false,
-                    "docs": [
-                        "Clock sysvar account"
-                    ]
                 }
             ],
             "args": [
@@ -1251,14 +1203,6 @@
                     "docs": [
                         "Oracle PDA to close"
                     ]
-                },
-                {
-                    "name": "clockSysvar",
-                    "isMut": false,
-                    "isSigner": false,
-                    "docs": [
-                        "Clock sysvar account"
-                    ]
                 }
             ],
             "args": [],

package/dist/idl/hash.d.ts

@@ -1 +1 @@
-export declare const ACTA_IDL_SHA256 = "8072bc43541635b8c359d8c0209c3ab63f6a264d6843997d20c9d6c9473130c9";
+export declare const ACTA_IDL_SHA256 = "34f93515df3ceed9854715fb73e9fe0de615383e5ff3f0d627ecd029e65e5688";

package/dist/idl/hash.js

@@ -1 +1 @@
-export const ACTA_IDL_SHA256 = "8072bc43541635b8c359d8c0209c3ab63f6a264d6843997d20c9d6c9473130c9";
+export const ACTA_IDL_SHA256 = "34f93515df3ceed9854715fb73e9fe0de615383e5ff3f0d627ecd029e65e5688";

package/dist/ws/apy.d.ts

@@ -42,7 +42,7 @@ export declare function computeApyFromAmounts(args: {
     premiumPerUnderlying: number;
     /** for puts: strike price per 1 underlying (quote units) */
     strikePrice: number;
-    /** for calls: current spot price per 1 underlying (quote units) */
+    /** current spot price per 1 underlying (quote units), required for both calls and puts */
     spotPrice?: number;
     /** seconds to option expiry (market expiry, not RFQ TTL) */
     secondsToExpiry: number;

package/dist/ws/apy.js

@@ -50,17 +50,11 @@ export function computeApyFromAmounts(args) {
     if (!Number.isFinite(premPU) || premPU < 0)
         throw new Error("invalid premiumPerUnderlying");
     const premiumNotional = qty * premPU;
-    let collateralPerUnderlying;
-    if (args.positionType === "cash_secured_put") {
-        collateralPerUnderlying = args.strikePrice;
-    }
-    else {
-        collateralPerUnderlying = args.spotPrice ?? NaN;
-    }
+    // Collateral always valued at spot so APR is monotonic across strikes.
+    // On-chain collateral requirements are unchanged — display metric only.
+    const collateralPerUnderlying = args.spotPrice ?? NaN;
     if (!Number.isFinite(collateralPerUnderlying) || collateralPerUnderlying <= 0) {
-        throw new Error(args.positionType === "covered_call"
-            ? "spotPrice is required for covered_call yield"
-            : "invalid strikePrice");
+        throw new Error("spotPrice is required for yield calculation");
     }
     const collateralNotional = qty * collateralPerUnderlying;
     const termYield = termYieldFromNotionals({ premiumNotional, collateralNotional });

package/dist/ws/apy.test.js

@@ -5,7 +5,7 @@ describe("ws apy helpers", () => {
             positionType: "covered_call",
             underlyingAmount: 10,
             spotPrice: 150,
-            strikePrice: 150, // not used for calls
+            strikePrice: 150, // not used for collateral, kept for API compat
             premiumPerUnderlying: 1.5,
             secondsToExpiry: 7 * 24 * 60 * 60,
         });
@@ -20,8 +20,44 @@ describe("ws apy helpers", () => {
             underlyingAmount: 10,
             grossPremiumPerUnit1e9: 1_500_000_000, // 1.5
             strike1e9: 150_000_000_000, // 150
+            spotPrice1e9: 150_000_000_000, // 150 (ATM)
             secondsToExpiry: 7 * 24 * 60 * 60,
         });
         expect(res.premiumNotional).toBeCloseTo(15, 10);
     });
+    it("put APR uses spot as collateral (not strike)", () => {
+        const spot = 150;
+        const strike = 120; // OTM put
+        const res = computeApyFromAmounts({
+            positionType: "cash_secured_put",
+            underlyingAmount: 1,
+            spotPrice: spot,
+            strikePrice: strike,
+            premiumPerUnderlying: 1.5,
+            secondsToExpiry: 30 * 24 * 60 * 60,
+        });
+        // collateral should be spot-based, not strike-based
+        expect(res.collateralNotional).toBeCloseTo(spot, 10);
+    });
+    it("put APR is monotonically decreasing for OTM strikes", () => {
+        const spot1e9 = 150_000_000_000; // 150
+        const strikes = [140, 130, 120, 110].map(s => s * 1_000_000_000);
+        // Premiums decrease with OTM (roughly realistic)
+        const premiums = [5, 2.5, 1, 0.3].map(p => p * 1_000_000_000);
+        const aprs = strikes.map((strike, i) => {
+            const res = computeApyFromScaledPrices({
+                positionType: "cash_secured_put",
+                underlyingAmount: 1,
+                grossPremiumPerUnit1e9: premiums[i],
+                strike1e9: strike,
+                spotPrice1e9: spot1e9,
+                secondsToExpiry: 30 * 24 * 60 * 60,
+            });
+            return res.apr;
+        });
+        // Each APR should be less than the previous
+        for (let i = 1; i < aprs.length; i++) {
+            expect(aprs[i]).toBeLessThan(aprs[i - 1]);
+        }
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acta-markets/ts-sdk",
-  "version": "0.0.19-beta",
+  "version": "0.0.20-beta",
   "description": "TypeScript SDK for Acta Protocol",
   "type": "module",
   "main": "dist/index.js",