@jpool/bond-sdk 0.11.0-next.22 → 0.11.0-next.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/dist/index.d.mts +302 -175
  2. package/dist/index.d.ts +302 -175
  3. package/dist/index.js +304 -176
  4. package/dist/index.js.map +1 -1
  5. package/dist/index.mjs +304 -176
  6. package/dist/index.mjs.map +1 -1
  7. package/package.json +1 -1
package/dist/index.d.mts CHANGED
@@ -14,7 +14,7 @@ type Jbond = {
14
14
  "address": "Fo17edWRJewZNTRibgx9iTfjywCW6dzS81VwBLmPFVq1";
15
15
  "metadata": {
16
16
  "name": "jbond";
17
- "version": "0.2.2";
17
+ "version": "0.2.3";
18
18
  "spec": "0.1.0";
19
19
  "description": "Jpool Bond Program";
20
20
  };
@@ -90,6 +90,9 @@ type Jbond = {
90
90
  {
91
91
  "name": "authority";
92
92
  "signer": true;
93
+ "relations": [
94
+ "bondState"
95
+ ];
93
96
  },
94
97
  {
95
98
  "name": "bondTokenAccount";
@@ -263,10 +266,12 @@ type Jbond = {
263
266
  {
264
267
  "name": "bondLockFunds";
265
268
  "docs": [
266
- "Locks funds for both the current and upcoming epoch.",
267
- "Moves collateral from available to locked state, making it unavailable for withdrawal for",
268
- "the current and next epoch. # Errors",
269
- "Fails if the validator is not active, or if there are insufficient available funds."
269
+ "Locks funds immediately, making them unavailable for withdrawal.",
270
+ "The locked amount takes effect immediately in the current epoch.",
271
+ "",
272
+ "# Errors",
273
+ "Fails if the bond type is not lockable, if the amount is zero,",
274
+ "or if there are insufficient available funds."
270
275
  ];
271
276
  "discriminator": [
272
277
  117,
@@ -364,6 +369,33 @@ type Jbond = {
364
369
  {
365
370
  "name": "bondState";
366
371
  "writable": true;
372
+ "pda": {
373
+ "seeds": [
374
+ {
375
+ "kind": "const";
376
+ "value": [
377
+ 98,
378
+ 111,
379
+ 110,
380
+ 100,
381
+ 95,
382
+ 115,
383
+ 116,
384
+ 97,
385
+ 116,
386
+ 101
387
+ ];
388
+ },
389
+ {
390
+ "kind": "arg";
391
+ "path": "bondType";
392
+ },
393
+ {
394
+ "kind": "arg";
395
+ "path": "bondName";
396
+ }
397
+ ];
398
+ };
367
399
  },
368
400
  {
369
401
  "name": "validatorBond";
@@ -451,10 +483,13 @@ type Jbond = {
451
483
  {
452
484
  "name": "bondReleaseFunds";
453
485
  "docs": [
454
- "Releases locked funds after an epoch ends.",
455
- "Moves collateral from locked back to available state, allowing withdrawals.",
486
+ "Queues funds for unlock in the next epoch.",
487
+ "The unlock is delayed by one epoch for security - funds remain locked",
488
+ "in the current epoch but will be available after epoch transition.",
489
+ "",
456
490
  "# Errors",
457
- "Fails if the validator is not active, or if there are insufficient locked funds."
491
+ "Fails if the bond type is not lockable, if the amount is zero,",
492
+ "or if the amount exceeds currently locked funds."
458
493
  ];
459
494
  "discriminator": [
460
495
  184,
@@ -733,15 +768,12 @@ type Jbond = {
733
768
  {
734
769
  "name": "bondUpdate";
735
770
  "docs": [
736
- "Transitions locked funds between epochs for a validator bond.",
737
- "",
738
- "This function should be called at epoch boundaries to update the bond's",
739
- "`last_update_epoch` and move the `next_epoch_locked` amount into",
740
- "`locked`. It ensures that the update only occurs once per epoch.",
771
+ "Applies any pending unlocks from previous epochs.",
741
772
  "",
742
- "# Errors",
743
- "Returns [`BondError::InvalidEpoch`] if called more than once in the same epoch,",
744
- "or if the system clock cannot be accessed."
773
+ "This instruction is optional - all other operations now automatically",
774
+ "sync the epoch state. It is kept for backwards compatibility and can",
775
+ "be used to explicitly trigger epoch synchronization without performing",
776
+ "another operation."
745
777
  ];
746
778
  "discriminator": [
747
779
  237,
@@ -760,7 +792,6 @@ type Jbond = {
760
792
  },
761
793
  {
762
794
  "name": "payer";
763
- "writable": true;
764
795
  "signer": true;
765
796
  }
766
797
  ];
@@ -983,38 +1014,6 @@ type Jbond = {
983
1014
  ];
984
1015
  "args": [];
985
1016
  },
986
- {
987
- "name": "migrateValidatorBond";
988
- "docs": [
989
- "migrate validator bond from legacy format to new format"
990
- ];
991
- "discriminator": [
992
- 214,
993
- 114,
994
- 65,
995
- 138,
996
- 248,
997
- 45,
998
- 186,
999
- 229
1000
- ];
1001
- "accounts": [
1002
- {
1003
- "name": "validatorBond";
1004
- "writable": true;
1005
- },
1006
- {
1007
- "name": "authority";
1008
- "writable": true;
1009
- "signer": true;
1010
- },
1011
- {
1012
- "name": "systemProgram";
1013
- "address": "11111111111111111111111111111111";
1014
- }
1015
- ];
1016
- "args": [];
1017
- },
1018
1017
  {
1019
1018
  "name": "sessionFinish";
1020
1019
  "docs": [
@@ -1160,6 +1159,19 @@ type Jbond = {
1160
1159
  }
1161
1160
  ];
1162
1161
  "events": [
1162
+ {
1163
+ "name": "bondConfigured";
1164
+ "discriminator": [
1165
+ 141,
1166
+ 252,
1167
+ 43,
1168
+ 54,
1169
+ 45,
1170
+ 157,
1171
+ 81,
1172
+ 14
1173
+ ];
1174
+ },
1163
1175
  {
1164
1176
  "name": "bondFinished";
1165
1177
  "discriminator": [
@@ -1173,6 +1185,32 @@ type Jbond = {
1173
1185
  191
1174
1186
  ];
1175
1187
  },
1188
+ {
1189
+ "name": "bondInitialized";
1190
+ "discriminator": [
1191
+ 73,
1192
+ 68,
1193
+ 161,
1194
+ 2,
1195
+ 214,
1196
+ 12,
1197
+ 169,
1198
+ 53
1199
+ ];
1200
+ },
1201
+ {
1202
+ "name": "bondRemoved";
1203
+ "discriminator": [
1204
+ 177,
1205
+ 200,
1206
+ 116,
1207
+ 123,
1208
+ 1,
1209
+ 244,
1210
+ 161,
1211
+ 240
1212
+ ];
1213
+ },
1176
1214
  {
1177
1215
  "name": "bondStarted";
1178
1216
  "discriminator": [
@@ -1187,16 +1225,16 @@ type Jbond = {
1187
1225
  ];
1188
1226
  },
1189
1227
  {
1190
- "name": "collateralToppedUp";
1228
+ "name": "collateralDeposited";
1191
1229
  "discriminator": [
1192
- 189,
1193
- 137,
1194
- 204,
1195
- 58,
1230
+ 244,
1231
+ 62,
1232
+ 77,
1233
+ 11,
1196
1234
  135,
1197
- 182,
1198
- 19,
1199
- 176
1235
+ 112,
1236
+ 61,
1237
+ 96
1200
1238
  ];
1201
1239
  },
1202
1240
  {
@@ -1225,6 +1263,32 @@ type Jbond = {
1225
1263
  32
1226
1264
  ];
1227
1265
  },
1266
+ {
1267
+ "name": "fundsLocked";
1268
+ "discriminator": [
1269
+ 227,
1270
+ 93,
1271
+ 162,
1272
+ 69,
1273
+ 181,
1274
+ 4,
1275
+ 71,
1276
+ 157
1277
+ ];
1278
+ },
1279
+ {
1280
+ "name": "fundsUnlocked";
1281
+ "discriminator": [
1282
+ 11,
1283
+ 240,
1284
+ 184,
1285
+ 107,
1286
+ 86,
1287
+ 187,
1288
+ 196,
1289
+ 128
1290
+ ];
1291
+ },
1228
1292
  {
1229
1293
  "name": "validatorRegistered";
1230
1294
  "discriminator": [
@@ -1237,33 +1301,46 @@ type Jbond = {
1237
1301
  95,
1238
1302
  72
1239
1303
  ];
1304
+ },
1305
+ {
1306
+ "name": "withdrawAuthorityChanged";
1307
+ "discriminator": [
1308
+ 91,
1309
+ 149,
1310
+ 224,
1311
+ 49,
1312
+ 187,
1313
+ 48,
1314
+ 190,
1315
+ 100
1316
+ ];
1240
1317
  }
1241
1318
  ];
1242
1319
  "errors": [
1243
1320
  {
1244
1321
  "code": 6000;
1245
- "name": "invalidVoteAccount";
1246
- "msg": "Invalid vote account";
1322
+ "name": "forbidden";
1323
+ "msg": "forbidden";
1247
1324
  },
1248
1325
  {
1249
1326
  "code": 6001;
1250
- "name": "identityMismatch";
1251
- "msg": "Identity does not match vote account";
1327
+ "name": "unauthorized";
1328
+ "msg": "unauthorized";
1252
1329
  },
1253
1330
  {
1254
1331
  "code": 6002;
1255
- "name": "insufficientCollateral";
1256
- "msg": "Insufficient collateral amount";
1332
+ "name": "invalidVoteAccount";
1333
+ "msg": "Invalid vote account";
1257
1334
  },
1258
1335
  {
1259
1336
  "code": 6003;
1260
- "name": "targetAprTooLow";
1261
- "msg": "Target APR is below minimum threshold";
1337
+ "name": "identityMismatch";
1338
+ "msg": "Vote account identity mismatch";
1262
1339
  },
1263
1340
  {
1264
1341
  "code": 6004;
1265
- "name": "mathOverflow";
1266
- "msg": "Math overflow";
1342
+ "name": "invalidMint";
1343
+ "msg": "Invalid mint address";
1267
1344
  },
1268
1345
  {
1269
1346
  "code": 6005;
@@ -1272,103 +1349,53 @@ type Jbond = {
1272
1349
  },
1273
1350
  {
1274
1351
  "code": 6006;
1275
- "name": "validatorNotActive";
1276
- "msg": "Validator bond account is not active";
1352
+ "name": "invalidArgument";
1353
+ "msg": "Invalid argument";
1277
1354
  },
1278
1355
  {
1279
1356
  "code": 6007;
1280
- "name": "validatorAlreadyRegistered";
1281
- "msg": "Validator already registered";
1357
+ "name": "insufficientBalance";
1358
+ "msg": "Insufficient balance";
1282
1359
  },
1283
1360
  {
1284
1361
  "code": 6008;
1285
- "name": "unauthorized";
1286
- "msg": "unauthorized";
1362
+ "name": "mathOverflow";
1363
+ "msg": "Math overflow";
1287
1364
  },
1288
1365
  {
1289
1366
  "code": 6009;
1290
- "name": "withdrawalLockedNearEpochEnd";
1291
- "msg": "Withdrawals are locked near the end of the epoch.";
1367
+ "name": "overflow";
1368
+ "msg": "Arithmetic overflow";
1292
1369
  },
1293
1370
  {
1294
1371
  "code": 6010;
1295
- "name": "missingTokenAccounts";
1296
- "msg": "Missing token accounts for token collateral type";
1372
+ "name": "bondNotRemovable";
1373
+ "msg": "Bond cannot be removed";
1297
1374
  },
1298
1375
  {
1299
1376
  "code": 6011;
1300
- "name": "missingTokenProgram";
1301
- "msg": "Token program is required for token collateral type";
1377
+ "name": "missingTokenAccounts";
1378
+ "msg": "Missing token accounts";
1302
1379
  },
1303
1380
  {
1304
1381
  "code": 6012;
1305
- "name": "invalidMint";
1306
- "msg": "Invalid mint for token collateral type";
1382
+ "name": "missingTokenProgram";
1383
+ "msg": "Missing token program";
1307
1384
  },
1308
1385
  {
1309
1386
  "code": 6013;
1310
1387
  "name": "missingStakeAccount";
1311
- "msg": "Stake account is required for stake account collateral type";
1388
+ "msg": "Missing stake account";
1312
1389
  },
1313
1390
  {
1314
1391
  "code": 6014;
1315
1392
  "name": "missingStakeProgram";
1316
- "msg": "Stake program is required for stake account collateral type";
1393
+ "msg": "Missing stake program";
1317
1394
  },
1318
1395
  {
1319
1396
  "code": 6015;
1320
- "name": "bondFinished";
1321
- "msg": "Bond is finished (deposits/withdrawals disabled)";
1322
- },
1323
- {
1324
- "code": 6016;
1325
- "name": "bondNotFinished";
1326
- "msg": "Bond is not finished";
1327
- },
1328
- {
1329
- "code": 6017;
1330
1397
  "name": "unsupportedCollateralType";
1331
1398
  "msg": "Unsupported collateral type";
1332
- },
1333
- {
1334
- "code": 6018;
1335
- "name": "overflow";
1336
- "msg": "Math operation overflowed";
1337
- },
1338
- {
1339
- "code": 6019;
1340
- "name": "incorrectBondType";
1341
- "msg": "Incorrect bond type for this operation";
1342
- },
1343
- {
1344
- "code": 6020;
1345
- "name": "bondNotFinishable";
1346
- "msg": "This bond type can't be finished";
1347
- },
1348
- {
1349
- "code": 6021;
1350
- "name": "invalidArgument";
1351
- "msg": "Invalid argument provided";
1352
- },
1353
- {
1354
- "code": 6022;
1355
- "name": "bondNotDisabled";
1356
- "msg": "Bond is not disabled";
1357
- },
1358
- {
1359
- "code": 6023;
1360
- "name": "bondNotEnabled";
1361
- "msg": "Bond is not enabled";
1362
- },
1363
- {
1364
- "code": 6024;
1365
- "name": "invalidEpoch";
1366
- "msg": "Invalid epoch for this operation";
1367
- },
1368
- {
1369
- "code": 6025;
1370
- "name": "bondNotRemovable";
1371
- "msg": "Bond is not removable";
1372
1399
  }
1373
1400
  ];
1374
1401
  "types": [
@@ -1402,6 +1429,26 @@ type Jbond = {
1402
1429
  ];
1403
1430
  };
1404
1431
  },
1432
+ {
1433
+ "name": "bondConfigured";
1434
+ "type": {
1435
+ "kind": "struct";
1436
+ "fields": [
1437
+ {
1438
+ "name": "bond";
1439
+ "type": "pubkey";
1440
+ },
1441
+ {
1442
+ "name": "authority";
1443
+ "type": "pubkey";
1444
+ },
1445
+ {
1446
+ "name": "timestamp";
1447
+ "type": "i64";
1448
+ }
1449
+ ];
1450
+ };
1451
+ },
1405
1452
  {
1406
1453
  "name": "bondFinished";
1407
1454
  "type": {
@@ -1457,6 +1504,46 @@ type Jbond = {
1457
1504
  ];
1458
1505
  };
1459
1506
  },
1507
+ {
1508
+ "name": "bondInitialized";
1509
+ "type": {
1510
+ "kind": "struct";
1511
+ "fields": [
1512
+ {
1513
+ "name": "bond";
1514
+ "type": "pubkey";
1515
+ },
1516
+ {
1517
+ "name": "authority";
1518
+ "type": "pubkey";
1519
+ },
1520
+ {
1521
+ "name": "timestamp";
1522
+ "type": "i64";
1523
+ }
1524
+ ];
1525
+ };
1526
+ },
1527
+ {
1528
+ "name": "bondRemoved";
1529
+ "type": {
1530
+ "kind": "struct";
1531
+ "fields": [
1532
+ {
1533
+ "name": "bond";
1534
+ "type": "pubkey";
1535
+ },
1536
+ {
1537
+ "name": "authority";
1538
+ "type": "pubkey";
1539
+ },
1540
+ {
1541
+ "name": "timestamp";
1542
+ "type": "i64";
1543
+ }
1544
+ ];
1545
+ };
1546
+ },
1460
1547
  {
1461
1548
  "name": "bondStarted";
1462
1549
  "type": {
@@ -1610,7 +1697,7 @@ type Jbond = {
1610
1697
  };
1611
1698
  },
1612
1699
  {
1613
- "name": "collateralToppedUp";
1700
+ "name": "collateralDeposited";
1614
1701
  "type": {
1615
1702
  "kind": "struct";
1616
1703
  "fields": [
@@ -1708,6 +1795,54 @@ type Jbond = {
1708
1795
  ];
1709
1796
  };
1710
1797
  },
1798
+ {
1799
+ "name": "fundsLocked";
1800
+ "type": {
1801
+ "kind": "struct";
1802
+ "fields": [
1803
+ {
1804
+ "name": "validator";
1805
+ "type": "pubkey";
1806
+ },
1807
+ {
1808
+ "name": "amount";
1809
+ "type": "u64";
1810
+ },
1811
+ {
1812
+ "name": "totalLocked";
1813
+ "type": "u64";
1814
+ },
1815
+ {
1816
+ "name": "epoch";
1817
+ "type": "u64";
1818
+ }
1819
+ ];
1820
+ };
1821
+ },
1822
+ {
1823
+ "name": "fundsUnlocked";
1824
+ "type": {
1825
+ "kind": "struct";
1826
+ "fields": [
1827
+ {
1828
+ "name": "validator";
1829
+ "type": "pubkey";
1830
+ },
1831
+ {
1832
+ "name": "amount";
1833
+ "type": "u64";
1834
+ },
1835
+ {
1836
+ "name": "pendingUnlock";
1837
+ "type": "u64";
1838
+ },
1839
+ {
1840
+ "name": "epoch";
1841
+ "type": "u64";
1842
+ }
1843
+ ];
1844
+ };
1845
+ },
1711
1846
  {
1712
1847
  "name": "globalConfigureData";
1713
1848
  "type": {
@@ -1804,21 +1939,21 @@ type Jbond = {
1804
1939
  {
1805
1940
  "name": "locked";
1806
1941
  "docs": [
1807
- "Amount of collateral currently locked"
1942
+ "Amount of collateral currently locked (unavailable for withdrawal)"
1808
1943
  ];
1809
1944
  "type": "u64";
1810
1945
  },
1811
1946
  {
1812
- "name": "nextEpochLocked";
1947
+ "name": "pendingUnlock";
1813
1948
  "docs": [
1814
- "Amount of collateral locked for the next epoch"
1949
+ "Pending unlock amount (will reduce `locked` next epoch)"
1815
1950
  ];
1816
1951
  "type": "u64";
1817
1952
  },
1818
1953
  {
1819
- "name": "lastUpdateEpoch";
1954
+ "name": "pendingUnlockEpoch";
1820
1955
  "docs": [
1821
- "The last epoch when the bond was updated"
1956
+ "Epoch when pending_unlock was queued"
1822
1957
  ];
1823
1958
  "type": "u64";
1824
1959
  }
@@ -1831,7 +1966,7 @@ type Jbond = {
1831
1966
  "kind": "struct";
1832
1967
  "fields": [
1833
1968
  {
1834
- "name": "identity";
1969
+ "name": "validator";
1835
1970
  "type": "pubkey";
1836
1971
  },
1837
1972
  {
@@ -1844,6 +1979,30 @@ type Jbond = {
1844
1979
  }
1845
1980
  ];
1846
1981
  };
1982
+ },
1983
+ {
1984
+ "name": "withdrawAuthorityChanged";
1985
+ "type": {
1986
+ "kind": "struct";
1987
+ "fields": [
1988
+ {
1989
+ "name": "validator";
1990
+ "type": "pubkey";
1991
+ },
1992
+ {
1993
+ "name": "oldAuthority";
1994
+ "type": {
1995
+ "option": "pubkey";
1996
+ };
1997
+ },
1998
+ {
1999
+ "name": "newAuthority";
2000
+ "type": {
2001
+ "option": "pubkey";
2002
+ };
2003
+ }
2004
+ ];
2005
+ };
1847
2006
  }
1848
2007
  ];
1849
2008
  "constants": [
@@ -2202,24 +2361,6 @@ declare class JBondClient {
2202
2361
  getBondSessionStartIx(props: BondStartProps): Promise<TransactionInstruction>;
2203
2362
  lockFunds(props: BondLockFunds): Promise<string | undefined>;
2204
2363
  releaseFunds(props: BondReleaseFunds): Promise<string | undefined>;
2205
- /**
2206
- * Update epoch locks
2207
- */
2208
- updateEpochLocks(props: {
2209
- bondType: BondType;
2210
- bondName: string;
2211
- voteAccount: PublicKeyInitData;
2212
- payer: PublicKey;
2213
- }): Promise<string | undefined>;
2214
- /**
2215
- * Build update epoch locks instruction
2216
- */
2217
- getUpdateEpochLocksIx(props: {
2218
- bondType: BondType;
2219
- bondName: string;
2220
- voteAccount: PublicKeyInitData;
2221
- payer: PublicKey;
2222
- }): Promise<TransactionInstruction>;
2223
2364
  /**
2224
2365
  * Build bond remove instruction
2225
2366
  */
@@ -2241,16 +2382,6 @@ declare class JBondClient {
2241
2382
  * Build lock funds instruction
2242
2383
  */
2243
2384
  getLockFundsIx(props: BondLockFunds): Promise<TransactionInstruction>;
2244
- migrateValidatorBond(props: {
2245
- bondType: BondType;
2246
- name: string;
2247
- voteAccount: PublicKeyInitData;
2248
- }): Promise<string | undefined>;
2249
- getMigrateValidatorBondIx(props: {
2250
- bondType: BondType;
2251
- name: string;
2252
- voteAccount: PublicKeyInitData;
2253
- }): Promise<TransactionInstruction>;
2254
2385
  /**
2255
2386
  * Build release funds instruction
2256
2387
  */
@@ -2387,8 +2518,8 @@ declare class JBondClient {
2387
2518
  createdAt: bn_js;
2388
2519
  bump: number;
2389
2520
  locked: bn_js;
2390
- nextEpochLocked: bn_js;
2391
- lastUpdateEpoch: bn_js;
2521
+ pendingUnlock: bn_js;
2522
+ pendingUnlockEpoch: bn_js;
2392
2523
  publicKey: PublicKey;
2393
2524
  }>;
2394
2525
  /**
@@ -2431,10 +2562,6 @@ declare const CROWDFUNDING_BOND_SEED = "crowdfunding";
2431
2562
  /**
2432
2563
  * Program IDs for different environments
2433
2564
  */
2434
- declare const ENV_PROGRAM_ID: {
2435
- dev: PublicKey;
2436
- stage: PublicKey;
2437
- prod: PublicKey;
2438
- };
2565
+ declare const ENV_PROGRAM_ID: Record<JBondClientEnv, string>;
2439
2566
 
2440
2567
  export { BOND_STATE_SEED, type BondConfigureProps, type BondFinishProps, type BondInitializeProps, type BondLockFunds, type BondReleaseFunds, type BondRemoveProps, type BondStartProps, type BondState, type BondStateStats, type BondStateStatus, BondTransactionType, BondType, CROWDFUNDING_BOND_SEED, type ClaimAllProps, type ClaimProps, type CollateralType, ENV_PROGRAM_ID, type EpochHistoryItem, GLOBAL_STATE_SEED, type GetHistoryGroupedProps, type GetHistoryProps, type GlobalConfigureProps, type GlobalInitializeProps, type GlobalState, JBondClient, JBondClientEnv, type JBondClientOptions, type Jbond, NodeWallet, type RegisterValidatorProps, STANDARD_BOND_SEED, SessionStatus, type SetWithdrawAuthorityProps, type TopUpCollateralProps, type TransactionHistoryItem, VALIDATOR_BOND_SEED, type ValidatorBond, type WithdrawCollateralProps };