@omegax/protocol-sdk 0.4.2 → 0.4.3

package/dist/protocol_seeds.d.ts

@@ -14,6 +14,12 @@ export declare const SEED_ORACLE_STAKE = "oracle_stake";
 export declare const SEED_POOL_ORACLE_POLICY = "pool_oracle_policy";
 export declare const SEED_POOL_TERMS = "pool_terms";
 export declare const SEED_POOL_ASSET_VAULT = "pool_asset_vault";
+export declare const SEED_POOL_ORACLE_PERMISSIONS = "pool_oracle_permissions";
+export declare const SEED_MEMBER_CYCLE = "member_cycle";
+export declare const SEED_CYCLE_QUOTE_REPLAY = "cycle_quote_replay";
+export declare const SEED_POOL_TREASURY_RESERVE = "pool_treasury_reserve";
+export declare const SEED_PROTOCOL_FEE_VAULT = "protocol_fee_vault";
+export declare const SEED_POOL_ORACLE_FEE_VAULT = "pool_oracle_fee_vault";
 export declare const SEED_SCHEMA = "schema";
 export declare const SEED_POOL_RULE = "pool_rule";
 export declare const SEED_INVITE_ISSUER = "invite_issuer";
@@ -95,6 +101,38 @@ export declare function derivePoolAssetVaultPda(params: {
     poolAddress: string | PublicKey;
     payoutMint: string | PublicKey;
 }): [PublicKey, number];
+export declare function derivePoolOraclePermissionSetPda(params: {
+    programId: string | PublicKey;
+    poolAddress: string | PublicKey;
+    oracle: string | PublicKey;
+}): [PublicKey, number];
+export declare function deriveMemberCyclePda(params: {
+    programId: string | PublicKey;
+    poolAddress: string | PublicKey;
+    member: string | PublicKey;
+    periodIndex: bigint | number;
+}): [PublicKey, number];
+export declare function deriveCycleQuoteReplayPda(params: {
+    programId: string | PublicKey;
+    poolAddress: string | PublicKey;
+    member: string | PublicKey;
+    nonceHash: Uint8Array;
+}): [PublicKey, number];
+export declare function derivePoolTreasuryReservePda(params: {
+    programId: string | PublicKey;
+    poolAddress: string | PublicKey;
+    paymentMint: string | PublicKey;
+}): [PublicKey, number];
+export declare function deriveProtocolFeeVaultPda(params: {
+    programId: string | PublicKey;
+    paymentMint: string | PublicKey;
+}): [PublicKey, number];
+export declare function derivePoolOracleFeeVaultPda(params: {
+    programId: string | PublicKey;
+    poolAddress: string | PublicKey;
+    oracle: string | PublicKey;
+    paymentMint: string | PublicKey;
+}): [PublicKey, number];
 export declare function deriveSchemaPda(params: {
     programId: string | PublicKey;
     schemaKeyHash: Uint8Array;

package/dist/protocol_seeds.js

@@ -14,6 +14,12 @@ export const SEED_ORACLE_STAKE = 'oracle_stake';
 export const SEED_POOL_ORACLE_POLICY = 'pool_oracle_policy';
 export const SEED_POOL_TERMS = 'pool_terms';
 export const SEED_POOL_ASSET_VAULT = 'pool_asset_vault';
+export const SEED_POOL_ORACLE_PERMISSIONS = 'pool_oracle_permissions';
+export const SEED_MEMBER_CYCLE = 'member_cycle';
+export const SEED_CYCLE_QUOTE_REPLAY = 'cycle_quote_replay';
+export const SEED_POOL_TREASURY_RESERVE = 'pool_treasury_reserve';
+export const SEED_PROTOCOL_FEE_VAULT = 'protocol_fee_vault';
+export const SEED_POOL_ORACLE_FEE_VAULT = 'pool_oracle_fee_vault';
 export const SEED_SCHEMA = 'schema';
 export const SEED_POOL_RULE = 'pool_rule';
 export const SEED_INVITE_ISSUER = 'invite_issuer';
@@ -130,6 +136,66 @@ export function derivePoolAssetVaultPda(params) {
     const mint = asPubkey(params.payoutMint);
     return PublicKey.findProgramAddressSync([Buffer.from(SEED_POOL_ASSET_VAULT), pool.toBuffer(), mint.toBuffer()], program);
 }
+function encodeU64Seed(value) {
+    const out = Buffer.alloc(8);
+    out.writeBigUInt64LE(typeof value === 'bigint' ? value : BigInt(value));
+    return out;
+}
+export function derivePoolOraclePermissionSetPda(params) {
+    const program = asPubkey(params.programId);
+    const pool = asPubkey(params.poolAddress);
+    const oracle = asPubkey(params.oracle);
+    return PublicKey.findProgramAddressSync([Buffer.from(SEED_POOL_ORACLE_PERMISSIONS), pool.toBuffer(), oracle.toBuffer()], program);
+}
+export function deriveMemberCyclePda(params) {
+    const program = asPubkey(params.programId);
+    const pool = asPubkey(params.poolAddress);
+    const member = asPubkey(params.member);
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(SEED_MEMBER_CYCLE),
+        pool.toBuffer(),
+        member.toBuffer(),
+        encodeU64Seed(params.periodIndex),
+    ], program);
+}
+export function deriveCycleQuoteReplayPda(params) {
+    const program = asPubkey(params.programId);
+    const pool = asPubkey(params.poolAddress);
+    const member = asPubkey(params.member);
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(SEED_CYCLE_QUOTE_REPLAY),
+        pool.toBuffer(),
+        member.toBuffer(),
+        Buffer.from(params.nonceHash),
+    ], program);
+}
+export function derivePoolTreasuryReservePda(params) {
+    const program = asPubkey(params.programId);
+    const pool = asPubkey(params.poolAddress);
+    const paymentMint = asPubkey(params.paymentMint);
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(SEED_POOL_TREASURY_RESERVE),
+        pool.toBuffer(),
+        paymentMint.toBuffer(),
+    ], program);
+}
+export function deriveProtocolFeeVaultPda(params) {
+    const program = asPubkey(params.programId);
+    const paymentMint = asPubkey(params.paymentMint);
+    return PublicKey.findProgramAddressSync([Buffer.from(SEED_PROTOCOL_FEE_VAULT), paymentMint.toBuffer()], program);
+}
+export function derivePoolOracleFeeVaultPda(params) {
+    const program = asPubkey(params.programId);
+    const pool = asPubkey(params.poolAddress);
+    const oracle = asPubkey(params.oracle);
+    const paymentMint = asPubkey(params.paymentMint);
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(SEED_POOL_ORACLE_FEE_VAULT),
+        pool.toBuffer(),
+        oracle.toBuffer(),
+        paymentMint.toBuffer(),
+    ], program);
+}
 export function deriveSchemaPda(params) {
     const program = asPubkey(params.programId);
     return PublicKey.findProgramAddressSync([Buffer.from(SEED_SCHEMA), Buffer.from(params.schemaKeyHash)], program);

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import type { PublicKey, Connection, Transaction } from '@solana/web3.js';
 export type ClaimLifecycleStatus = 'prepared' | 'submitted' | 'confirmed' | 'failed' | 'expired';
-export type ClaimFailureCode = 'invalid_claimant_wallet' | 'wallet_mismatch' | 'pool_not_found' | 'pool_not_active' | 'membership_not_active' | 'claim_window_not_set' | 'claim_window_not_open' | 'claim_window_closed' | 'no_passing_outcomes' | 'intent_expired' | 'intent_message_mismatch' | 'required_signer_mismatch' | 'simulation_failed_insufficient_funds' | 'simulation_failed_pool_paused' | 'simulation_failed_membership_invalid' | 'simulation_failed_unknown' | 'rpc_rejected' | 'rpc_timeout' | 'already_claimed' | 'unknown';
+export type ClaimFailureCode = 'invalid_claimant_wallet' | 'wallet_mismatch' | 'pool_not_found' | 'pool_not_active' | 'membership_not_active' | 'claim_window_not_set' | 'claim_window_not_open' | 'claim_window_closed' | 'no_passing_outcomes' | 'seeker_rule_misconfigured' | 'seeker_commitment_disabled' | 'intent_expired' | 'intent_message_mismatch' | 'required_signer_mismatch' | 'simulation_failed_insufficient_funds' | 'simulation_failed_pool_paused' | 'simulation_failed_membership_invalid' | 'simulation_failed_unknown' | 'rpc_rejected' | 'rpc_timeout' | 'already_claimed' | 'unknown';
 export interface ClaimFailureDetail {
     code: ClaimFailureCode;
     message: string;
@@ -25,6 +25,8 @@ export interface RewardSummary {
         claimableRaw: string;
         claimableUi: string;
         status: 'eligible' | 'not_eligible' | 'pending' | 'claimed' | 'failed';
+        errorCode?: string | null;
+        errorMessage?: string | null;
     };
 }
 export interface ClaimIntent {
@@ -348,6 +350,164 @@ export interface BuildSubmitClaimTxParams {
     recentBlockhash: string;
     programId: string;
 }
+export interface ProtocolCycleQuoteFields {
+    poolAddress: string;
+    member: string;
+    productIdHashHex: string;
+    paymentMint: string;
+    premiumAmountRaw: bigint;
+    canonicalPremiumAmount: bigint;
+    periodIndex: bigint;
+    commitmentEnabled: boolean;
+    bondAmountRaw: bigint;
+    shieldFeeRaw: bigint;
+    protocolFeeRaw: bigint;
+    oracleFeeRaw: bigint;
+    netPoolPremiumRaw: bigint;
+    totalAmountRaw: bigint;
+    includedShieldCount: number;
+    thresholdBps: number;
+    expiresAtTs: bigint;
+    nonceHashHex: string;
+    quoteMetaHashHex: string;
+}
+export interface BuildActivateCycleWithQuoteSolTxParams {
+    payer: string;
+    member: string;
+    poolAddress: string;
+    oracle: string;
+    productIdHashHex: string;
+    premiumAmountRaw: bigint;
+    canonicalPremiumAmount: bigint;
+    periodIndex: bigint;
+    commitmentEnabled: boolean;
+    bondAmountRaw: bigint;
+    shieldFeeRaw: bigint;
+    protocolFeeRaw: bigint;
+    oracleFeeRaw: bigint;
+    netPoolPremiumRaw: bigint;
+    totalAmountRaw: bigint;
+    includedShieldCount: number;
+    thresholdBps: number;
+    expiresAtTs: bigint;
+    nonceHashHex: string;
+    quoteMetaHashHex: string;
+    quoteMessage: Uint8Array;
+    oracleSecretKey: Uint8Array;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildActivateCycleWithQuoteSplTxParams {
+    payer: string;
+    member: string;
+    poolAddress: string;
+    oracle: string;
+    productIdHashHex: string;
+    paymentMint: string;
+    premiumAmountRaw: bigint;
+    canonicalPremiumAmount: bigint;
+    periodIndex: bigint;
+    commitmentEnabled: boolean;
+    bondAmountRaw: bigint;
+    shieldFeeRaw: bigint;
+    protocolFeeRaw: bigint;
+    oracleFeeRaw: bigint;
+    netPoolPremiumRaw: bigint;
+    totalAmountRaw: bigint;
+    includedShieldCount: number;
+    thresholdBps: number;
+    expiresAtTs: bigint;
+    nonceHashHex: string;
+    quoteMetaHashHex: string;
+    quoteMessage: Uint8Array;
+    oracleSecretKey: Uint8Array;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildSettleCycleCommitmentTxParams {
+    payer: string;
+    oracle: string;
+    member: string;
+    poolAddress: string;
+    productIdHashHex: string;
+    paymentMint: string;
+    periodIndex: bigint;
+    passed: boolean;
+    shieldConsumed: boolean;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildSettleCycleCommitmentSolTxParams {
+    payer: string;
+    oracle: string;
+    member: string;
+    poolAddress: string;
+    productIdHashHex: string;
+    periodIndex: bigint;
+    passed: boolean;
+    shieldConsumed: boolean;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildWithdrawPoolTreasurySplTxParams {
+    payer: string;
+    oracle: string;
+    poolAddress: string;
+    paymentMint: string;
+    amount: bigint;
+    recipientTokenAccount: string;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildWithdrawPoolTreasurySolTxParams {
+    payer: string;
+    oracle: string;
+    poolAddress: string;
+    amount: bigint;
+    recipientSystemAccount: string;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildSetPoolCoverageReserveFloorTxParams {
+    authority: string;
+    poolAddress: string;
+    paymentMint: string;
+    amount: bigint;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildWithdrawProtocolFeeSplTxParams {
+    governanceAuthority: string;
+    paymentMint: string;
+    amount: bigint;
+    recipientTokenAccount: string;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildWithdrawProtocolFeeSolTxParams {
+    governanceAuthority: string;
+    amount: bigint;
+    recipientSystemAccount: string;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildWithdrawPoolOracleFeeSplTxParams {
+    oracle: string;
+    poolAddress: string;
+    paymentMint: string;
+    amount: bigint;
+    recipientTokenAccount: string;
+    recentBlockhash: string;
+    programId: string;
+}
+export interface BuildWithdrawPoolOracleFeeSolTxParams {
+    oracle: string;
+    poolAddress: string;
+    amount: bigint;
+    recipientSystemAccount: string;
+    recentBlockhash: string;
+    programId: string;
+}
 export interface ProtocolClient {
     connection: Connection;
     programId: PublicKey;
@@ -363,6 +523,17 @@ export interface ProtocolClient {
     buildRevokeMemberTx?: (params: BuildRevokeMemberTxParams) => Transaction;
     buildSubmitOutcomeAttestationTx?: (params: BuildSubmitOutcomeAttestationTxParams) => Transaction;
     buildSubmitClaimTx?: (params: BuildSubmitClaimTxParams) => Transaction;
+    buildActivateCycleWithQuoteSolTx?: (params: BuildActivateCycleWithQuoteSolTxParams) => Transaction;
+    buildActivateCycleWithQuoteSplTx?: (params: BuildActivateCycleWithQuoteSplTxParams) => Transaction;
+    buildSettleCycleCommitmentTx?: (params: BuildSettleCycleCommitmentTxParams) => Transaction;
+    buildSettleCycleCommitmentSolTx?: (params: BuildSettleCycleCommitmentSolTxParams) => Transaction;
+    buildWithdrawPoolTreasurySplTx?: (params: BuildWithdrawPoolTreasurySplTxParams) => Transaction;
+    buildWithdrawPoolTreasurySolTx?: (params: BuildWithdrawPoolTreasurySolTxParams) => Transaction;
+    buildSetPoolCoverageReserveFloorTx?: (params: BuildSetPoolCoverageReserveFloorTxParams) => Transaction;
+    buildWithdrawProtocolFeeSplTx?: (params: BuildWithdrawProtocolFeeSplTxParams) => Transaction;
+    buildWithdrawProtocolFeeSolTx?: (params: BuildWithdrawProtocolFeeSolTxParams) => Transaction;
+    buildWithdrawPoolOracleFeeSplTx?: (params: BuildWithdrawPoolOracleFeeSplTxParams) => Transaction;
+    buildWithdrawPoolOracleFeeSolTx?: (params: BuildWithdrawPoolOracleFeeSolTxParams) => Transaction;
     fetchProtocolConfig?: () => Promise<ProtocolConfigAccount | null>;
     fetchPool?: (poolAddress: string) => Promise<ProtocolPoolAccount | null>;
     fetchOracleRegistryEntry?: (oracle: string) => Promise<ProtocolOracleRegistryEntryAccount | null>;
@@ -439,6 +610,16 @@ export interface ProtocolClient {
         poolAddress: string;
         payoutMint: string;
     }) => Promise<ProtocolPoolAssetVaultAccount | null>;
+    fetchProtocolFeeVault?: (paymentMint: string) => Promise<ProtocolFeeVaultAccount | null>;
+    fetchPoolOracleFeeVault?: (params: {
+        poolAddress: string;
+        oracle: string;
+        paymentMint: string;
+    }) => Promise<ProtocolPoolOracleFeeVaultAccount | null>;
+    fetchPoolOraclePermissionSet?: (params: {
+        poolAddress: string;
+        oracle: string;
+    }) => Promise<ProtocolPoolOraclePermissionSetAccount | null>;
     fetchOutcomeSchema?: (schemaKeyHashHex: string) => Promise<ProtocolOutcomeSchemaRegistryEntryAccount | null>;
     fetchPoolOutcomeRule?: (params: {
         poolAddress: string;
@@ -485,6 +666,20 @@ export interface ProtocolClient {
         poolAddress: string;
         member: string;
     }) => Promise<ProtocolCoveragePolicyPositionNftAccount | null>;
+    fetchMemberCycle?: (params: {
+        poolAddress: string;
+        member: string;
+        periodIndex: bigint | number;
+    }) => Promise<ProtocolMemberCycleAccount | null>;
+    fetchCycleQuoteReplay?: (params: {
+        poolAddress: string;
+        member: string;
+        nonceHashHex: string;
+    }) => Promise<ProtocolCycleQuoteReplayAccount | null>;
+    fetchPoolTreasuryReserve?: (params: {
+        poolAddress: string;
+        paymentMint: string;
+    }) => Promise<ProtocolPoolTreasuryReserveAccount | null>;
     fetchPremiumLedger?: (params: {
         poolAddress: string;
         member: string;
@@ -532,6 +727,7 @@ export interface ProtocolPoolOraclePolicyAccount {
     quorumM: number;
     quorumN: number;
     requireVerifiedSchema: boolean;
+    oracleFeeBps: number;
     allowDelegateClaim: boolean;
     bump: number;
 }
@@ -555,6 +751,71 @@ export interface ProtocolPoolAssetVaultAccount {
     active: boolean;
     bump: number;
 }
+export interface ProtocolFeeVaultAccount {
+    address: string;
+    paymentMint: string;
+    bump: number;
+}
+export interface ProtocolPoolOracleFeeVaultAccount {
+    address: string;
+    pool: string;
+    oracle: string;
+    paymentMint: string;
+    bump: number;
+}
+export interface ProtocolPoolOraclePermissionSetAccount {
+    address: string;
+    pool: string;
+    oracle: string;
+    permissions: number;
+    bump: number;
+}
+export type ProtocolMemberCycleStatus = 'active' | 'settled' | 'unknown';
+export interface ProtocolMemberCycleAccount {
+    address: string;
+    pool: string;
+    member: string;
+    productIdHashHex: string;
+    periodIndex: bigint;
+    paymentMint: string;
+    premiumAmountRaw: bigint;
+    bondAmountRaw: bigint;
+    shieldFeeRaw: bigint;
+    protocolFeeRaw: bigint;
+    oracleFeeRaw: bigint;
+    netPoolPremiumRaw: bigint;
+    totalAmountRaw: bigint;
+    canonicalPremiumAmount: bigint;
+    commitmentEnabled: boolean;
+    thresholdBps: number;
+    includedShieldCount: number;
+    shieldConsumed: boolean;
+    statusCode: number;
+    status: ProtocolMemberCycleStatus;
+    passed: boolean;
+    activatedAt: number;
+    settledAt: number;
+    quoteHashHex: string;
+    bump: number;
+}
+export interface ProtocolCycleQuoteReplayAccount {
+    address: string;
+    pool: string;
+    member: string;
+    nonceHashHex: string;
+    quoteHashHex: string;
+    createdAt: number;
+    bump: number;
+}
+export interface ProtocolPoolTreasuryReserveAccount {
+    address: string;
+    pool: string;
+    paymentMint: string;
+    reservedRefundAmount: bigint;
+    reservedRewardAmount: bigint;
+    manualCoverageReserveAmount: bigint;
+    bump: number;
+}
 export interface ProtocolOutcomeSchemaRegistryEntryAccount {
     address: string;
     schemaKeyHashHex: string;
@@ -599,6 +860,7 @@ export interface ProtocolCycleOutcomeAggregateAccount {
     finalized: boolean;
     passed: boolean;
     claimed: boolean;
+    rewardLiabilityReserved: boolean;
     latestAsOfTs: number;
     bump: number;
 }
@@ -844,6 +1106,7 @@ export interface BuildSetPoolOraclePolicyTxParams {
     quorumM: number;
     quorumN: number;
     requireVerifiedSchema: boolean;
+    oracleFeeBps: number;
     allowDelegateClaim: boolean;
     recentBlockhash: string;
     programId: string;
@@ -954,6 +1217,7 @@ export interface BuildSubmitOutcomeAttestationVoteTxParams {
     cycleId: string;
     ruleHashHex: string;
     schemaKeyHashHex: string;
+    payoutMint: string;
     attestationDigestHex: string;
     observedValueHashHex: string;
     asOfTs: number;
@@ -966,6 +1230,7 @@ export interface BuildFinalizeCycleOutcomeTxParams {
     member: string;
     cycleId: string;
     ruleHashHex: string;
+    payoutMint: string;
     recentBlockhash: string;
     payer: string;
     programId: string;
@@ -978,6 +1243,7 @@ export interface BuildSubmitRewardClaimTxParams {
     ruleHashHex: string;
     intentHashHex: string;
     payoutAmount: bigint;
+    payoutMint: string;
     recipient: string;
     recipientSystemAccount: string;
     claimDelegate?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omegax/protocol-sdk",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "TypeScript SDK for OmegaX protocol integrations on Solana devnet beta (mainnet coming soon).",
   "keywords": [
     "omegax",