@velocity-exchange/sdk 0.3.0 → 0.6.0

package/lib/browser/idl/velocity.d.ts

@@ -8,7 +8,7 @@ export type Velocity = {
     "address": "vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P";
     "metadata": {
         "name": "velocity";
-        "version": "2.162.0";
+        "version": "2.163.0";
         "spec": "0.1.0";
         "description": "Created with Anchor";
     };
@@ -6382,6 +6382,33 @@ export type Velocity = {
                 }
             ];
         },
+        {
+            "name": "resetEquityFloorBreaker";
+            "discriminator": [
+                230,
+                181,
+                202,
+                36,
+                127,
+                56,
+                56,
+                27
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "state";
+                },
+                {
+                    "name": "userStats";
+                    "writable": true;
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "resetPerpMarketAmmOracleTwap";
             "discriminator": [
@@ -7740,6 +7767,10 @@ export type Velocity = {
                 {
                     "name": "amount";
                     "type": "u64";
+                },
+                {
+                    "name": "equityFloorDelta";
+                    "type": "u64";
                 }
             ];
         },
@@ -8222,6 +8253,39 @@ export type Velocity = {
                 }
             ];
         },
+        {
+            "name": "tripEquityFloorBreaker";
+            "discriminator": [
+                133,
+                184,
+                25,
+                80,
+                193,
+                52,
+                162,
+                249
+            ];
+            "accounts": [
+                {
+                    "name": "state";
+                },
+                {
+                    "name": "keeper";
+                    "docs": [
+                        "Any signer may trip the breaker; the proof is the margin calculation."
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "user";
+                },
+                {
+                    "name": "userStats";
+                    "writable": true;
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "updateAdmin";
             "discriminator": [
@@ -9438,6 +9502,9 @@ export type Velocity = {
                 {
                     "name": "authority";
                     "signer": true;
+                    "relations": [
+                        "keeperStats"
+                    ];
                 }
             ];
             "args": [];
@@ -11087,13 +11154,13 @@ export type Velocity = {
                 133
             ];
             "accounts": [
-                {
-                    "name": "admin";
-                    "signer": true;
-                },
                 {
                     "name": "state";
                     "writable": true;
+                },
+                {
+                    "name": "admin";
+                    "signer": true;
                 }
             ];
             "args": [
@@ -12227,6 +12294,38 @@ export type Velocity = {
                 }
             ];
         },
+        {
+            "name": "updateUserEquityFloor";
+            "discriminator": [
+                49,
+                87,
+                139,
+                119,
+                136,
+                239,
+                186,
+                104
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "state";
+                },
+                {
+                    "name": "user";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "equityFloor";
+                    "type": "u64";
+                }
+            ];
+        },
         {
             "name": "updateUserIdle";
             "discriminator": [
@@ -16017,6 +16116,21 @@ export type Velocity = {
             "code": 6356;
             "name": "invalidNativePerpMarketAccount";
             "msg": "Native dispatch: supplied market account is not a Velocity perp market";
+        },
+        {
+            "code": 6357;
+            "name": "isolatedPositionDisabled";
+            "msg": "Isolated positions are not enabled in this build";
+        },
+        {
+            "code": 6358;
+            "name": "equityBelowFloor";
+            "msg": "Account equity is below the user-set equity floor";
+        },
+        {
+            "code": 6359;
+            "name": "invalidEquityFloorTransfer";
+            "msg": "Invalid equity floor transfer between subaccounts";
         }
     ];
     "types": [
@@ -23721,7 +23835,26 @@ export type Velocity = {
                         "type": {
                             "array": [
                                 "u8",
-                                14
+                                3
+                            ];
+                        };
+                    },
+                    {
+                        "name": "equityFloor";
+                        "docs": [
+                            "Minimum account equity (cross-margin total collateral) required for",
+                            "risk-increasing orders, fills, withdrawals and deposit transfers.",
+                            "Settable only by the warm/cold admin; 0 disables the check.",
+                            "precision: QUOTE_PRECISION"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "padding2";
+                        "type": {
+                            "array": [
+                                "u8",
+                                8
                             ];
                         };
                     }
@@ -23910,12 +24043,22 @@ export type Velocity = {
                         ];
                         "type": "u8";
                     },
+                    {
+                        "name": "equityBreakerTripped";
+                        "docs": [
+                            "Set by the permissionless `trip_equity_floor_breaker` instruction when",
+                            "any of the authority's subaccounts falls below its equity floor.",
+                            "While set, every subaccount of the authority rejects risk-increasing",
+                            "fills, withdrawals and transfers out. Cleared only by the warm admin."
+                        ];
+                        "type": "u8";
+                    },
                     {
                         "name": "padding";
                         "type": {
                             "array": [
                                 "u8",
-                                63
+                                62
                             ];
                         };
                     }

package/lib/browser/idl/velocity.json

@@ -2,7 +2,7 @@
     "address": "vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P",
     "metadata": {
         "name": "velocity",
-        "version": "2.162.0",
+        "version": "2.163.0",
         "spec": "0.1.0",
         "description": "Created with Anchor"
     },
@@ -6376,6 +6376,33 @@
                 }
             ]
         },
+        {
+            "name": "reset_equity_floor_breaker",
+            "discriminator": [
+                230,
+                181,
+                202,
+                36,
+                127,
+                56,
+                56,
+                27
+            ],
+            "accounts": [
+                {
+                    "name": "admin",
+                    "signer": true
+                },
+                {
+                    "name": "state"
+                },
+                {
+                    "name": "user_stats",
+                    "writable": true
+                }
+            ],
+            "args": []
+        },
         {
             "name": "reset_perp_market_amm_oracle_twap",
             "discriminator": [
@@ -7734,6 +7761,10 @@
                 {
                     "name": "amount",
                     "type": "u64"
+                },
+                {
+                    "name": "equity_floor_delta",
+                    "type": "u64"
                 }
             ]
         },
@@ -8216,6 +8247,39 @@
                 }
             ]
         },
+        {
+            "name": "trip_equity_floor_breaker",
+            "discriminator": [
+                133,
+                184,
+                25,
+                80,
+                193,
+                52,
+                162,
+                249
+            ],
+            "accounts": [
+                {
+                    "name": "state"
+                },
+                {
+                    "name": "keeper",
+                    "docs": [
+                        "Any signer may trip the breaker; the proof is the margin calculation."
+                    ],
+                    "signer": true
+                },
+                {
+                    "name": "user"
+                },
+                {
+                    "name": "user_stats",
+                    "writable": true
+                }
+            ],
+            "args": []
+        },
         {
             "name": "update_admin",
             "discriminator": [
@@ -9431,7 +9495,10 @@
                 },
                 {
                     "name": "authority",
-                    "signer": true
+                    "signer": true,
+                    "relations": [
+                        "keeper_stats"
+                    ]
                 }
             ],
             "args": []
@@ -11081,13 +11148,13 @@
                 133
             ],
             "accounts": [
-                {
-                    "name": "admin",
-                    "signer": true
-                },
                 {
                     "name": "state",
                     "writable": true
+                },
+                {
+                    "name": "admin",
+                    "signer": true
                 }
             ],
             "args": [
@@ -12221,6 +12288,38 @@
                 }
             ]
         },
+        {
+            "name": "update_user_equity_floor",
+            "discriminator": [
+                49,
+                87,
+                139,
+                119,
+                136,
+                239,
+                186,
+                104
+            ],
+            "accounts": [
+                {
+                    "name": "admin",
+                    "signer": true
+                },
+                {
+                    "name": "state"
+                },
+                {
+                    "name": "user",
+                    "writable": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "equity_floor",
+                    "type": "u64"
+                }
+            ]
+        },
         {
             "name": "update_user_idle",
             "discriminator": [
@@ -16011,6 +16110,21 @@
             "code": 6356,
             "name": "InvalidNativePerpMarketAccount",
             "msg": "Native dispatch: supplied market account is not a Velocity perp market"
+        },
+        {
+            "code": 6357,
+            "name": "IsolatedPositionDisabled",
+            "msg": "Isolated positions are not enabled in this build"
+        },
+        {
+            "code": 6358,
+            "name": "EquityBelowFloor",
+            "msg": "Account equity is below the user-set equity floor"
+        },
+        {
+            "code": 6359,
+            "name": "InvalidEquityFloorTransfer",
+            "msg": "Invalid equity floor transfer between subaccounts"
         }
     ],
     "types": [
@@ -23715,7 +23829,26 @@
                         "type": {
                             "array": [
                                 "u8",
-                                14
+                                3
+                            ]
+                        }
+                    },
+                    {
+                        "name": "equity_floor",
+                        "docs": [
+                            "Minimum account equity (cross-margin total collateral) required for",
+                            "risk-increasing orders, fills, withdrawals and deposit transfers.",
+                            "Settable only by the warm/cold admin; 0 disables the check.",
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "padding2",
+                        "type": {
+                            "array": [
+                                "u8",
+                                8
                             ]
                         }
                     }
@@ -23904,12 +24037,22 @@
                         ],
                         "type": "u8"
                     },
+                    {
+                        "name": "equity_breaker_tripped",
+                        "docs": [
+                            "Set by the permissionless `trip_equity_floor_breaker` instruction when",
+                            "any of the authority's subaccounts falls below its equity floor.",
+                            "While set, every subaccount of the authority rejects risk-increasing",
+                            "fills, withdrawals and transfers out. Cleared only by the warm admin."
+                        ],
+                        "type": "u8"
+                    },
                     {
                         "name": "padding",
                         "type": {
                             "array": [
                                 "u8",
-                                63
+                                62
                             ]
                         }
                     }

package/lib/browser/keypair.d.ts

@@ -1,2 +1,10 @@
 import { Keypair } from '@solana/web3.js';
+/**
+ * Loads a Solana `Keypair` from a private key given in any of the common CLI/env formats.
+ * @param privateKey - One of: a filesystem path to a JSON keypair file (checked first via
+ * `fs.existsSync`); a JSON array string (e.g. `"[1,2,3,...]"`); a comma-separated list of byte
+ * values (e.g. `"1,2,3,..."`); or a base58-encoded secret key string (whitespace is stripped).
+ * @returns The decoded `Keypair`.
+ * @throws Error (from `Keypair.fromSecretKey`) if the decoded bytes are not a valid 64-byte secret key.
+ */
 export declare function loadKeypair(privateKey: string): Keypair;

package/lib/browser/keypair.js

@@ -7,6 +7,14 @@ exports.loadKeypair = void 0;
 const fs_1 = __importDefault(require("fs"));
 const bs58_1 = __importDefault(require("bs58"));
 const web3_js_1 = require("@solana/web3.js");
+/**
+ * Loads a Solana `Keypair` from a private key given in any of the common CLI/env formats.
+ * @param privateKey - One of: a filesystem path to a JSON keypair file (checked first via
+ * `fs.existsSync`); a JSON array string (e.g. `"[1,2,3,...]"`); a comma-separated list of byte
+ * values (e.g. `"1,2,3,..."`); or a base58-encoded secret key string (whitespace is stripped).
+ * @returns The decoded `Keypair`.
+ * @throws Error (from `Keypair.fromSecretKey`) if the decoded bytes are not a valid 64-byte secret key.
+ */
 function loadKeypair(privateKey) {
     // try to load privateKey as a filepath
     let loadedKey;