@overcast-xyz/solana-program 0.1.1

package/dist/overcast_settlement_oracle_gated.d.ts

@@ -0,0 +1,578 @@
+/**
+ * Program IDL in camelCase format in order to be used in JS/TS.
+ *
+ * Note that this is only a type helper and is not the actual IDL. The original
+ * IDL can be found at `target/idl/overcast_settlement_oracle_gated.json`.
+ */
+export type OvercastSettlementOracleGated = {
+    address: "7gbzZmp7PyQBSHJDUM8jYrLsKTXoJDGa3GUVUQhCzNwB";
+    metadata: {
+        name: "overcastSettlementOracleGated";
+        version: "0.1.0";
+        spec: "0.1.0";
+        description: "Oracle-gated settlement layer for Overcast options";
+    };
+    instructions: [
+        {
+            name: "canBorrow";
+            discriminator: [23, 180, 16, 136, 86, 168, 84, 152];
+            accounts: [
+                {
+                    name: "config";
+                }
+            ];
+            args: [
+                {
+                    name: "option";
+                    type: {
+                        defined: {
+                            name: "marketOption";
+                        };
+                    };
+                },
+                {
+                    name: "borrower";
+                    type: "pubkey";
+                },
+                {
+                    name: "borrowAmount";
+                    type: "u64";
+                },
+                {
+                    name: "collateralReceiver";
+                    type: "pubkey";
+                },
+                {
+                    name: "metadata";
+                    type: "bytes";
+                }
+            ];
+        },
+        {
+            name: "canExercise";
+            discriminator: [114, 239, 61, 62, 83, 204, 139, 83];
+            accounts: [
+                {
+                    name: "config";
+                }
+            ];
+            args: [
+                {
+                    name: "option";
+                    type: {
+                        defined: {
+                            name: "marketOption";
+                        };
+                    };
+                },
+                {
+                    name: "exerciseAmount";
+                    type: "u64";
+                },
+                {
+                    name: "metadata";
+                    type: "bytes";
+                }
+            ];
+            returns: {
+                defined: {
+                    name: "exerciseResolution";
+                };
+            };
+        },
+        {
+            name: "canMatch";
+            discriminator: [223, 238, 7, 233, 72, 137, 146, 135];
+            accounts: [
+                {
+                    name: "config";
+                }
+            ];
+            args: [
+                {
+                    name: "option";
+                    type: {
+                        defined: {
+                            name: "marketOption";
+                        };
+                    };
+                }
+            ];
+        },
+        {
+            name: "canRedeem";
+            docs: [
+                "Oracle-gated redeem resolution — see the [`SettlementLayer`] impl in",
+                "`crate::layer`. Redemption is the option's unwind, not its exercise, so it",
+                "does not consult the oracle."
+            ];
+            discriminator: [88, 241, 152, 58, 50, 172, 234, 99];
+            accounts: [
+                {
+                    name: "config";
+                }
+            ];
+            args: [
+                {
+                    name: "option";
+                    type: {
+                        defined: {
+                            name: "marketOption";
+                        };
+                    };
+                },
+                {
+                    name: "redeemAmount";
+                    type: "u64";
+                },
+                {
+                    name: "claimSupply";
+                    type: "u64";
+                },
+                {
+                    name: "collateralBalance";
+                    type: "u64";
+                },
+                {
+                    name: "settlementBalance";
+                    type: "u64";
+                },
+                {
+                    name: "metadata";
+                    type: "bytes";
+                }
+            ];
+            returns: {
+                defined: {
+                    name: "redeemResolution";
+                };
+            };
+        },
+        {
+            name: "initializeConfig";
+            discriminator: [208, 127, 21, 1, 194, 190, 196, 70];
+            accounts: [
+                {
+                    name: "authority";
+                    writable: true;
+                    signer: true;
+                },
+                {
+                    name: "collMint";
+                    docs: [
+                        "Collateral-leg mint. Pubkey participates in PDA derivation; raw data is",
+                        "read once to cache `decimals`."
+                    ];
+                },
+                {
+                    name: "settMint";
+                    docs: ["Settlement-leg mint."];
+                },
+                {
+                    name: "collOracleSample";
+                    docs: [
+                        "Sample oracle account for the collateral leg. Verifies that the",
+                        "`(coll_oracle_kind, coll_oracle_id)` tuple resolves to a real feed.",
+                        "Not stored."
+                    ];
+                },
+                {
+                    name: "settOracleSample";
+                    docs: ["Sample oracle account for the settlement leg."];
+                },
+                {
+                    name: "config";
+                    writable: true;
+                },
+                {
+                    name: "systemProgram";
+                    address: "11111111111111111111111111111111";
+                }
+            ];
+            args: [
+                {
+                    name: "collOracleKind";
+                    type: {
+                        defined: {
+                            name: "oracleKind";
+                        };
+                    };
+                },
+                {
+                    name: "collOracleId";
+                    type: {
+                        array: ["u8", 32];
+                    };
+                },
+                {
+                    name: "settOracleKind";
+                    type: {
+                        defined: {
+                            name: "oracleKind";
+                        };
+                    };
+                },
+                {
+                    name: "settOracleId";
+                    type: {
+                        array: ["u8", 32];
+                    };
+                },
+                {
+                    name: "maxStalenessSecs";
+                    type: "u32";
+                },
+                {
+                    name: "maxConfBps";
+                    type: "u32";
+                },
+                {
+                    name: "intrinsicResolution";
+                    type: "bool";
+                }
+            ];
+        }
+    ];
+    accounts: [
+        {
+            name: "oracleSettlementConfig";
+            discriminator: [27, 90, 115, 138, 246, 10, 107, 57];
+        }
+    ];
+    errors: [
+        {
+            code: 6000;
+            name: "invalidCollateralAmount";
+            msg: "Collateral amount must be non-zero";
+        },
+        {
+            code: 6001;
+            name: "exerciseAmountTooLarge";
+            msg: "Exercise amount exceeds available collateral";
+        },
+        {
+            code: 6002;
+            name: "arithmeticOverflow";
+            msg: "Arithmetic overflow computing settlement";
+        },
+        {
+            code: 6003;
+            name: "mintBindingMismatch";
+            msg: "Option's collateral/settlement mints do not match the config binding";
+        },
+        {
+            code: 6004;
+            name: "feedIdMismatch";
+            msg: "Supplied oracle account's feed id does not match the config";
+        },
+        {
+            code: 6005;
+            name: "priceStale";
+            msg: "Oracle price is older than max_staleness_secs";
+        },
+        {
+            code: 6006;
+            name: "confidenceTooWide";
+            msg: "Oracle confidence interval is wider than max_conf_bps";
+        },
+        {
+            code: 6007;
+            name: "notInTheMoney";
+            msg: "Option is not in the money under the bound oracle";
+        },
+        {
+            code: 6008;
+            name: "unsupportedOracleKind";
+            msg: "OracleKind variant is not yet supported by this build";
+        },
+        {
+            code: 6009;
+            name: "invalidMintAccount";
+            msg: "Account supplied as a mint is too short to be a valid SPL Mint";
+        },
+        {
+            code: 6010;
+            name: "invalidPrice";
+            msg: "Oracle returned a non-positive price";
+        },
+        {
+            code: 6011;
+            name: "borrowNotSupported";
+            msg: "This settlement layer does not permit borrowing collateral";
+        }
+    ];
+    types: [
+        {
+            name: "exerciseResolution";
+            docs: [
+                "A settlement layer returns this from `can_exercise` to instruct core how to",
+                "move escrowed funds. Core owns custody of all option assets; layers are pure",
+                "decision modules."
+            ];
+            type: {
+                kind: "struct";
+                fields: [
+                    {
+                        name: "collateralToTaker";
+                        docs: [
+                            "Collateral asset moved from option escrow to maker escrow (e.g. cashless leftover)."
+                        ];
+                        type: "u64";
+                    },
+                    {
+                        name: "settlementFromTaker";
+                        docs: [
+                            "Settlement asset pulled from taker to maker. Zero for cashless settlement."
+                        ];
+                        type: "u64";
+                    }
+                ];
+            };
+        },
+        {
+            name: "marketOption";
+            docs: [
+                "A live option, as passed to a settlement layer / hook. Mirrors",
+                "`overcast_core::state::MarketOption` byte-for-byte."
+            ];
+            type: {
+                kind: "struct";
+                fields: [
+                    {
+                        name: "details";
+                        type: {
+                            defined: {
+                                name: "optionDetails";
+                            };
+                        };
+                    },
+                    {
+                        name: "taker";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "maker";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "settlementOffer";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "collateralOffer";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "borrowedCollateral";
+                        docs: [
+                            "Collateral currently out on loan via `borrow_collateral` and not yet",
+                            "returned via `repay_collateral`."
+                        ];
+                        type: "u64";
+                    }
+                ];
+            };
+        },
+        {
+            name: "optionDetails";
+            docs: [
+                "The economic terms of an option, as seen by a settlement layer / hook.",
+                "",
+                "Mirrors `overcast_core::state::OptionDetails` byte-for-byte — core owns the",
+                "on-chain account representation, this is the shared interface view."
+            ];
+            type: {
+                kind: "struct";
+                fields: [
+                    {
+                        name: "domain";
+                        type: "u32";
+                    },
+                    {
+                        name: "startTimestamp";
+                        type: "i64";
+                    },
+                    {
+                        name: "endTimestamp";
+                        type: "i64";
+                    },
+                    {
+                        name: "premiumAsset";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "premiumAmount";
+                        type: "u64";
+                    },
+                    {
+                        name: "collateralAsset";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "collateralAmount";
+                        type: "u64";
+                    },
+                    {
+                        name: "settlementAsset";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "settlementAmount";
+                        type: "u64";
+                    },
+                    {
+                        name: "settlementLayer";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "borrowAllowed";
+                        docs: [
+                            "Opt-in flag: if false, `borrow_collateral` is hard-rejected by core",
+                            "regardless of what the settlement layer says. If true, the layer is",
+                            "CPI'd and can still refuse."
+                        ];
+                        type: "bool";
+                    }
+                ];
+            };
+        },
+        {
+            name: "oracleKind";
+            docs: ["Tagged oracle source. Discriminants are seed-encoded."];
+            repr: {
+                kind: "rust";
+            };
+            type: {
+                kind: "enum";
+                variants: [
+                    {
+                        name: "pyth";
+                    }
+                ];
+            };
+        },
+        {
+            name: "oracleSettlementConfig";
+            docs: [
+                "Per-instance config for the oracle-gated settlement layer.",
+                "",
+                "The PDA seed encodes the full (assets, oracle bindings) tuple, so the",
+                "pubkey alone is self-describing. Operational policy (staleness, confidence)",
+                "is stored in data and immutable post-init."
+            ];
+            type: {
+                kind: "struct";
+                fields: [
+                    {
+                        name: "collMint";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "settMint";
+                        type: "pubkey";
+                    },
+                    {
+                        name: "collDecimals";
+                        docs: [
+                            "Cached at init from the mint account; spares `can_exercise` from having",
+                            "to take the mint accounts on every call. SPL Mint decimals are immutable",
+                            "so the snapshot is permanently valid."
+                        ];
+                        type: "u8";
+                    },
+                    {
+                        name: "settDecimals";
+                        type: "u8";
+                    },
+                    {
+                        name: "collOracleKind";
+                        type: {
+                            defined: {
+                                name: "oracleKind";
+                            };
+                        };
+                    },
+                    {
+                        name: "collOracleId";
+                        type: {
+                            array: ["u8", 32];
+                        };
+                    },
+                    {
+                        name: "settOracleKind";
+                        type: {
+                            defined: {
+                                name: "oracleKind";
+                            };
+                        };
+                    },
+                    {
+                        name: "settOracleId";
+                        type: {
+                            array: ["u8", 32];
+                        };
+                    },
+                    {
+                        name: "maxStalenessSecs";
+                        type: "u32";
+                    },
+                    {
+                        name: "maxConfBps";
+                        type: "u32";
+                    },
+                    {
+                        name: "intrinsicResolution";
+                        docs: [
+                            "Settlement style for exercise. `false` = physical: the taker pays the",
+                            "full proportional settlement and receives the full exercised collateral.",
+                            "`true` = intrinsic (cash-settled): the taker pays no settlement and is",
+                            "instead paid the option's profit only, denominated in the collateral",
+                            "asset (`(valueColl - valueSett) / priceColl`); the remaining collateral",
+                            "stays escrowed for the maker to redeem. Immutable post-init."
+                        ];
+                        type: "bool";
+                    },
+                    {
+                        name: "bump";
+                        type: "u8";
+                    }
+                ];
+            };
+        },
+        {
+            name: "redeemResolution";
+            docs: [
+                "A settlement layer returns this from `can_redeem` to instruct core how much",
+                "of each escrow to release to the maker. The redemption analogue of",
+                "[`ExerciseResolution`]: redemption only ever unwinds the two escrows back to",
+                "the maker, so the taker-facing fields are dropped."
+            ];
+            type: {
+                kind: "struct";
+                fields: [
+                    {
+                        name: "collateralToMaker";
+                        docs: [
+                            "Collateral asset released from the option escrow to the maker."
+                        ];
+                        type: "u64";
+                    },
+                    {
+                        name: "settlementToMaker";
+                        docs: [
+                            "Settlement asset released from the option escrow to the maker."
+                        ];
+                        type: "u64";
+                    }
+                ];
+            };
+        }
+    ];
+    constants: [
+        {
+            name: "settlementConfigSeed";
+            type: "bytes";
+            value: "[115, 101, 116, 116, 108, 101, 109, 101, 110, 116, 45, 99, 111, 110, 102, 105, 103]";
+        }
+    ];
+};

package/dist/overcast_settlement_oracle_gated.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });