@hobba-io/core 0.1.0

package/src/constants.ts

@@ -0,0 +1,263 @@
+import { PublicKey } from "@solana/web3.js";
+
+// Program IDs
+export const PROGRAM_ID_SURFPOOL = new PublicKey("3X2QyJ4Da5b5VaZ6mMcUgUm4V2t8emLrSeRwM4i2YNYH");
+export const PROGRAM_ID_STAGING = new PublicKey("soBBAHNhFyWF4QBCK9BJLVkX6d6NZt37ozNaPV5aq3H");
+export const PROGRAM_ID_MAINNET = new PublicKey("Hobbakk1LmW2DhE4nAKnCeU1iK7V7pKHTq3ihaE2i8qG");
+export const PROGRAM_ID =
+  process.env.NEXT_PUBLIC_MAINNET === "true" ? PROGRAM_ID_MAINNET :
+  process.env.NEXT_PUBLIC_STAGING === "true" ? PROGRAM_ID_STAGING :
+  PROGRAM_ID_SURFPOOL;
+export const KAMINO_LENDING_PROGRAM_ID = new PublicKey("KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD");
+export const KVAULT_PROGRAM_ID = new PublicKey("KvauGMspG5k6rtzrqqn7WNn3oZdyKqLKwK2XWQ8FLjd");
+export const FARMS_PROGRAM = new PublicKey("FarmsPZpWu9i7Kky8tPN37rs2TpmMrAZrC7S7vJa91Hr");
+export const JUPLEND_PROGRAM = new PublicKey("jupr81YtYssSyPt8jbnGuiWon5f6x9TcDEFxYe3Bdzi");
+
+// Perena Vault
+export const PERENA_PROGRAM_ID = new PublicKey("save8RQVPMWNTzU18t3GBvBkN9hT7jsGjiCQ28FpD9H");
+export const STAR_USDC_MINT = new PublicKey("star9agSpjiFe3M49B3RniVU4CMBBEK3Qnaqn3RGiFM");
+export const PERENA_VAULT_STATE = new PublicKey("sM6P4mh53CnG4faN4Fo3seY7wMSAiHdy8o6gKjwQF7A");
+export const PERENA_VAULT_AUTHORITY = new PublicKey("3bZ1qY6wfzyDH7QMPiRKLr6k8p1asdtyjvJyJsJBdv23");
+export const PERENA_POOL_CONFIG = new PublicKey("CmKFP4YJg5QpAryUm9xk5QD611bccYMzZvpvQDJkMwt6");
+export const PERENA_VAULT_USDC_TRANSIT = new PublicKey("HvG7HSrNHVAcjzgwt3UVtnY9srkrY7qnMG4zS1SnPQT2");
+export const PERENA_VAULT_METADATA = new PublicKey("3msJbxNbSeosztbNEB1eFPitMFnP8ogCszegPUswipdL");
+export const PERENA_FEE_COLLECTOR = new PublicKey("6tqLkhbqJSx4KG616VhNCvsaFqcDPok7wdbzU2DmEAub");
+// MarginFi accounts used by Perena
+export const PERENA_MARGINFI_PROGRAM = new PublicKey("MFv2hWf31Z9kbCa1snEPYctwafyhdvnV7FZnsebVacA");
+export const PERENA_MARGINFI_GROUP = new PublicKey("4qp6Fx6tnZkY5Wropq9wUYgtFxXKwE6viZxFHg3rdAG8");
+export const PERENA_MARGINFI_ACCOUNT = new PublicKey("C8JLFVMuSFFFmDX2AEyMmP6zRXtXwJgptHeBUrnj4zLE");
+export const PERENA_MARGINFI_BANK = new PublicKey("2s37akK2eyBbp8DZgCm7RtsaEz8eJP3Nxd4urLHQv7yB");
+export const PERENA_MARGINFI_BANK_AUTHORITY = new PublicKey("3uxNepDbmkDNq6JhRja5Z8QwbTrfmkKP8AKZV5chYDGG");
+export const PERENA_MARGINFI_BANK_LIQUIDITY_VAULT = new PublicKey("7jaiZR5Sk8hdYN9MxTpczTcwbWpb5WEoxSANuUwveuat");
+export const PERENA_MARGINFI_ORACLE = new PublicKey("Dpw1EAVrSB1ibxiDQyTAW6Zip3J4Btk2x4SgApQCeFbX");
+
+// Vault provider constants
+export const VAULT_PROVIDER_KVAULT = 0;
+export const VAULT_PROVIDER_PERENA = 1;
+
+// Lending provider constants (stored in userState.lendingProvider)
+export const LENDING_PROVIDER_KAMINO: number = 0;
+export const LENDING_PROVIDER_JUPLEND: number = 1;
+// Default for newly-initialized user accounts
+export const DEFAULT_LENDING_PROVIDER: number = LENDING_PROVIDER_JUPLEND;
+export const JUPLEND_LIQUIDITY_PROGRAM = new PublicKey("jupeiUmn818Jg1ekPURTpr4mFo29p46vygyykFJ3wZC");
+export const JUPLEND_ORACLE_PROGRAM = new PublicKey("jupnw4B6Eqs7ft6rxpzYLJZYSnrpRgPcr589n5Kv4oc");
+export const ATA_PROGRAM_ID = new PublicKey("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL");
+export const METAPLEX_PROGRAM = new PublicKey("metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s");
+
+// Mints
+export const CBBTC_MINT = new PublicKey("cbbtcf3aa214zXHbiAZQwf4122FBYbraNdFqgw4iMij");
+export const SOL_MINT = new PublicKey("So11111111111111111111111111111111111111112");
+export const USDC_MINT = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
+
+// Kamino Lending Markets
+export const MAIN_MARKET = new PublicKey("7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF");
+export const XSTOCKS_MARKET = new PublicKey("5wJeMrUYECGq41fxRESKALVcHnNX26TAWy4W98yULsua");
+
+// XStocks Reserve addresses
+export const XSTOCKS_CBBTC_RESERVE = new PublicKey("5AWpVYJvNASoUM8toSDQRcVyA9dvoUuFj5qNx9v32bjj");
+export const XSTOCKS_USDC_RESERVE = new PublicKey("97zoywd8mPZsGTg8q1wdD2Wgkdrs2tqusp1Qqcxbyj7E");
+export const XSTOCKS_CBBTC_LIQUIDITY_SUPPLY = new PublicKey("CVfVcPUCj8KiQ1zDFhSrLBjXC1TKCwisvNLdKSPTCtUc");
+export const XSTOCKS_CBBTC_COLLATERAL_MINT = new PublicKey("5GcFF6eYtTVWHi1oexFB6xt771ZRWP1txeMXKSGtkoPF");
+export const XSTOCKS_CBBTC_COLLATERAL_SUPPLY = new PublicKey("JXDy94Qha1n2NKqNn1nC9QHHatmtbW2mM9VTse7TQut");
+export const XSTOCKS_USDC_LIQUIDITY_SUPPLY = new PublicKey("72Gz8BM8vDr5zdeHmFB5A2ptNZYfVgDuw5LDkNwGDdTA");
+export const XSTOCKS_USDC_FEE_VAULT = new PublicKey("DPHXY8LbH4cPPAgBDNnrU7B2XwmhWcBZ9wTBi3uZpfh4");
+export const XSTOCKS_USDC_RESERVE_FARM_DEBT = new PublicKey("82eHAjSXZEyA3UpBxTjVYXF4QJmAEtLR6kvWXQca7mqd");
+
+// cbBTC Reserve (Main Market)
+export const CBBTC_RESERVE = new PublicKey("37Jk2zkz23vkAYBT66HM2gaqJuNg2nYLsCreQAVt5MWK");
+export const CBBTC_LIQUIDITY_SUPPLY = new PublicKey("BcPpdmg4vxXSenvkp12XbVp6XnzwKChnzfNa6cQXLW96");
+export const CBBTC_FEE_VAULT = new PublicKey("7NSusA45pkEApHBVqS5CqnWW9WR98uEUT6d5hDPdgD8A");
+export const CBBTC_COLLATERAL_MINT = new PublicKey("B3ieCZaTUp8qM9zbPqH2WDhzWpwrvHB2Q2aWB25DW97U");
+export const CBBTC_COLLATERAL_SUPPLY = new PublicKey("hY6yiVepYxxv6dpzayYQ9LnhkX7yrFFpep3oxFRKRgi");
+export const CBBTC_RESERVE_FARM_COLLATERAL = new PublicKey("9CinLHLAcMkzs4Ji8pwS2qwyz1LU46A4Ry7BNLGLubxs");
+
+// SOL Reserve (Main Market)
+export const SOL_RESERVE = new PublicKey("d4A2prbA2whesmvHaL88BH6Ewn5N4bTSU2Ze8P6Bc4Q");
+export const SOL_LIQUIDITY_SUPPLY = new PublicKey("GafNuUXj9rxGLn4y79dPu6MHSuPWeJR6UtTWuexpGh3U");
+export const SOL_FEE_VAULT = new PublicKey("3JNof8s453bwG5UqiXBLJc77NRQXezYYEBbk3fqnoKph");
+export const SOL_COLLATERAL_MINT = new PublicKey("2UywZrUdyqs5vDchy7fKQJKau2RVyuzBev2XKGPDSiX1");
+export const SOL_COLLATERAL_SUPPLY = new PublicKey("8NXMyRD91p3nof61BTkJvrfpGTASHygz1cUvc3HvwyGS");
+export const SOL_RESERVE_FARM_COLLATERAL = new PublicKey("955xWFhSDcDiUgUr4sBRtCpTLiMd4H5uZLAmgtP3R3sX");
+
+// USDC Reserve
+export const USDC_RESERVE = new PublicKey("D6q6wuQSrifJKZYpR1M8R4YawnLDtDsMmWM1NbBmgJ59");
+export const USDC_LIQUIDITY_SUPPLY = new PublicKey("Bgq7trRgVMeq33yt235zM2onQ4bRDBsY5EWiTetF4qw6");
+export const USDC_FEE_VAULT = new PublicKey("BbDUrk1bVtSixgQsPLBJFZEF7mwGstnD5joA1WzYvYFX");
+export const USDC_COLLATERAL_MINT = new PublicKey("B8V6WVjPxW1UGwVDfxH2d2r8SyT4cqn7dQRK6XneVa7D");
+export const USDC_COLLATERAL_SUPPLY = new PublicKey("3DzjXRfxRm6iejfyyMynR4tScddaanrePJ1NJU2XnPPL");
+
+// Oracle
+export const SCOPE_PRICES = new PublicKey("3t4JZcueEzTbVP6kLxXrL3VpWx45jDer4eqysweBchNH");
+
+// KVault (Allez USDC)
+export const ALLEZ_USDC_VAULT = new PublicKey("A1USdzqDHmw5oz97AkqAGLxEQZfFjASZFuy4T6Qdvnpo");
+export const ALLEZ_USDC_SHARES_MINT = new PublicKey("BDh5h1uqhdL3pdCcTB1AEc2dyRsorDx9fF8Y72H1XZu8");
+export const ALLEZ_USDC_TOKEN_VAULT = new PublicKey("H4GHPfd4vxCEmor13P3HBS1AKawE2Mhv6fyWLaswn8d5");
+export const ALLEZ_USDC_VAULT_AUTHORITY = new PublicKey("GhxheH2FYN9pDvjpAKYgwVmLRGGPsw79v2DSQLQu9o7T");
+export const VAULT_LOOKUP_TABLE = new PublicKey("3hi1c3L11vL446LJotFZNXHp1YZSLQ867SeQJUc9b5t1");
+
+// Vault withdraw addresses
+export const CTOKEN_VAULT_MAIN_USDC = new PublicKey("5ADikyCXfgM7A3h2QNJwtaXV1XAMQv6ywHZcAH2fJRrK");
+export const LENDING_MARKET_AUTHORITY_MAIN = new PublicKey("9DrvZvyWh1HuAoZxvYWMvkf2XCzryCpGgHqrMjyDWpmo");
+
+// USDC Prime Vault
+export const USDC_PRIME_VAULT = new PublicKey("HDsayqAsDWy3QvANGqh2yNraqcD8Fnjgh73Mhb3WRS5E");
+export const USDC_PRIME_SHARES_MINT = new PublicKey("7D8C5pDFxug58L9zkwK7bCiDg4kD4AygzbcZUmf5usHS");
+export const USDC_PRIME_TOKEN_VAULT = new PublicKey("CKTEDx5z19CntAB9B66AxuS98S1NuCgMvfpsew7TQwi");
+export const USDC_PRIME_VAULT_AUTHORITY = new PublicKey("AyY6VCkHfTWdFs7SqBbu6AnCqLUhgzVHBzW3WcJu5Jc8");
+export const USDC_PRIME_LOOKUP_TABLE = new PublicKey("9p2oT9J6BojHigd3V5qXzrwsQf4dtgMgLxtrzLVR3rwu");
+
+// Altcoin Market
+export const ALTCOIN_MARKET = new PublicKey("DxXdAyU3kCjnyggvHmY5nAwg5cRbbmdyX3npfDMjjMek");
+export const ALTCOIN_USDC_RESERVE = new PublicKey("Ga4rZytCpq1unD4DbEJ5bkHeUz9g3oh9AAFEi6vSauXp");
+export const ALTCOIN_CTOKEN_VAULT = new PublicKey("5rGkiF4Jf1rPTJ6nazBgcjewVktXhagwcw5Nux7GccRi");
+export const ALTCOIN_LENDING_MARKET_AUTHORITY = new PublicKey("B9spsrMK6pJicYtukaZzDyzsUQLgc3jbx5gHVwdDxb6y");
+export const ALTCOIN_LIQUIDITY_SUPPLY = new PublicKey("GENey8es3EgGiNTM8H8gzA3vf98haQF8LHiYFyErjgrv");
+export const ALTCOIN_CTOKEN_MINT = new PublicKey("32XLsweyeQwWgLKRVAzS72nxHGU1JmmNQQZ3C3q6fBjJ");
+
+// JLP Market
+export const JLP_MARKET = new PublicKey("GMqmFygF5iSm5nkckYU6tieggFcR42SyjkkhK5rswFRs");
+export const JLP_USDC_RESERVE = new PublicKey("9FRZvAsjDJ6WM8BJ2S45h9PoDCLAq8DNY9zZDX7MyGzT");
+
+// RockawayRWA Vault
+export const ROCKAWAY_RWA_VAULT = new PublicKey("DWSXb18xZApz29vnQpgR2m6MynCT7PznaXt7Ut7M7KaP");
+export const ROCKAWAY_RWA_SHARES_MINT = new PublicKey("DgHN3q3dSYAchNX7V3D4aYiTWMx8RHTgHbfPiwiqBkE9");
+export const ROCKAWAY_RWA_TOKEN_VAULT = new PublicKey("6ea6GorjfT2SmUH8HSwg4LLae5RCqVVEYzcznBJEge9e");
+export const ROCKAWAY_RWA_VAULT_AUTHORITY = new PublicKey("D6hDbSjooxfjXrfKo7xBKVFeoaJrtnXY75uAbxeFbPgU");
+export const ROCKAWAY_RWA_LOOKUP_TABLE = new PublicKey("GzavHphVhGp9PERAfT3NcQwFesevQD386puHtVtsbq6m");
+
+// RWA Market
+export const RWA_MARKET = new PublicKey("9Y7uwXgQ68mGqRtZfuFaP4hc4fxeJ7cE9zTtqTxVhfGU");
+export const RWA_MARKET_AUTHORITY = new PublicKey("CzEcTo66owDYLH1ieFR64u4gV5YT3FSLEg8G61nAvuP1");
+export const RWA_USDC_RESERVE = new PublicKey("6XdN3zXeoYKgfSeZb8h1LpiEkUXRJ3CbimE5FJ35XFBP");
+export const RWA_CTOKEN_VAULT = new PublicKey("5BDugAB1RXHkxFhL1oye4o2zbu8j8uHb3xDrzm4Evvuv");
+export const RWA_LIQUIDITY_SUPPLY = new PublicKey("EetQRys9azm1GsK476sr3R3W2hw79eUbBCmvGt83LoNc");
+export const RWA_COLLATERAL_MINT = new PublicKey("GresxT3Ditj5N9sHi6qTBoy96tctJ4HknUX2tCMiri3M");
+
+// JupLend addresses
+export const JUPLEND_VAULT_CONFIG = new PublicKey("2L6xsj9zKbvxALDroGQHmPx2kCw8RqZ8yru4zceUoB6k");
+export const JUPLEND_VAULT_STATE = new PublicKey("HnSMEmypWgJ1a6JNnBycccsBeQQvqNKphgSMquCaFiy9");
+export const JUPLEND_ORACLE = new PublicKey("BU4FbopNHBseTnrck5HyvocWN7PcS9SMhrKTNLagzx3z");
+export const JUPLEND_POOL_PDA = new PublicKey("4Pgx2M7ZsDRvXU4CitoT94EJUohxqSk3eBuLsoz834dm");
+export const JUPLEND_SUPPLY_RESERVES_LIQUIDITY = new PublicKey("DALcPrc81yGgwqaBuuCRXtEU8PHFLv2xEgWyhnfvbVKH");
+export const JUPLEND_BORROW_RESERVES_LIQUIDITY = new PublicKey("94vK29npVbyRHXH63rRcTiSr26SFhrQTzbpNJuhQEDu");
+export const JUPLEND_VAULT_SUPPLY_POSITION = new PublicKey("GzsJrAYkxPbYimVA98yVMRWABrHH8F49MK49KVPzncdR");
+export const JUPLEND_VAULT_BORROW_POSITION = new PublicKey("3NQ98P7E8pUu3YjFymuEZMnQzGdBci6hKYEKcUneskYX");
+export const JUPLEND_SUPPLY_RATE_MODEL = new PublicKey("EqpNebkM6hdhPGQw7wMkC5ctCjja8z7Z7DCt2K1tuMPu");
+export const JUPLEND_BORROW_RATE_MODEL = new PublicKey("5pjzT5dFTsXcwixoab1QDLvZQvpYJxJeBphkyfHGn688");
+export const JUPLEND_VAULT_SUPPLY_TOKEN_ACCOUNT = new PublicKey("E7VPMhsjvVXpGVFMJRJgJjRmc5bhERpRjtYEbmBhWNcF");
+export const JUPLEND_VAULT_BORROW_TOKEN_ACCOUNT = new PublicKey("BmkUoKMFYBxNSzWXyUjyMJjMAaVz4d8ZnxwwmhDCUXFB");
+export const JUPLEND_LIQUIDITY = new PublicKey("7s1da8DduuBFqGra5bJBjpnvL5E9mGzCuMk1Qkh4or2Z");
+export const JUPLEND_ORACLE_SOURCE = new PublicKey("4cSM2e6rvbGQUFiJbqytoVMi5GgghSMr8LwVrT9VPSPo");
+export const JUPLEND_BRANCH = new PublicKey("Ctz7yPaqtvyAu7eHrM9U9AKjNoKuS35nT8smY8FutAMe");
+export const JUPLEND_TICK_0 = new PublicKey("GYA5nRHDMsTuf6sQ1dQYpS9ktoy6UXuuV767spLMT919");
+export const JUPLEND_TICK_1 = new PublicKey("ASTTBXCW2Uqpko4VjZVx2yY917oKA3nim2QnqpzuhYnT");
+export const JUPLEND_NEW_BRANCH = new PublicKey("HgN61oe85k7Yrw93ZA7Bx4GkEhmzv446dD9NV5qx5DWR");
+// Position tick PDAs (from SDK / mainnet — used as defaults for operate remaining accounts)
+export const JUPLEND_POS_TICK_CURRENT = new PublicKey("CUsGshjra7qaj2eCDfWHDgLkXWNQa1P9s9nBMM9sHAkV");
+export const JUPLEND_POS_TICK_FINAL = new PublicKey("EFdXq8G1CgszjZtrcYBDTW6twq8ZbLbusStFruxUBcnP");
+export const JUPLEND_POS_TICK_ID_CURRENT = new PublicKey("CJvFuAcL7CKfPJfJoD2BT9R7CHG3ttTKMzxxyDcUkqWH");
+export const JUPLEND_POS_TICK_ID_FINAL = new PublicKey("5zAx5YDifpHSdK2BguH2hvxUVVzL2qBeFwBSAtxySpF1");
+export const JUPLEND_VAULT_ID = 11;
+export const JUPLEND_SOL_VAULT_ID = 1;
+export const JUPLEND_MAX_TICK = 16383;
+
+// Resolve JupLend vault ID from collateral mint
+export function resolveJuplendVaultId(collateralMint: PublicKey): number {
+  if (collateralMint.equals(SOL_MINT)) return JUPLEND_SOL_VAULT_ID;
+  if (collateralMint.equals(CBBTC_MINT)) return JUPLEND_VAULT_ID;
+  throw new Error(`Unsupported JupLend collateral mint: ${collateralMint.toBase58()}`);
+}
+
+// Derive JupLend vault config PDA for any vault ID
+export function deriveJuplendVaultConfigPda(vaultId: number): PublicKey {
+  const buf = Buffer.alloc(2);
+  buf.writeUInt16LE(vaultId);
+  return PublicKey.findProgramAddressSync(
+    [Buffer.from("vault_config"), buf],
+    JUPLEND_PROGRAM
+  )[0];
+}
+
+// Derive JupLend vault state PDA for any vault ID
+export function deriveJuplendVaultStatePda(vaultId: number): PublicKey {
+  const buf = Buffer.alloc(2);
+  buf.writeUInt16LE(vaultId);
+  return PublicKey.findProgramAddressSync(
+    [Buffer.from("vault_state"), buf],
+    JUPLEND_PROGRAM
+  )[0];
+}
+
+// Refresh instruction discriminators
+export const REFRESH_RESERVE_DISCRIMINATOR = Buffer.from([2, 218, 138, 235, 79, 201, 25, 102]);
+export const REFRESH_OBLIGATION_DISCRIMINATOR = Buffer.from([33, 132, 147, 228, 151, 192, 72, 89]);
+
+// UserState layout offsets
+// 8 (disc) + 1 (version) + 32 (owner) + 32 (obligation) + 32 (lending_market) + 1 (lending_provider) + 1 (bump)
+export const DEPOSITED_TO_VAULT_OFFSET = 8 + 1 + 32 + 32 + 32 + 1 + 1;
+export const CURRENT_VAULT_OFFSET = DEPOSITED_TO_VAULT_OFFSET + 8;
+export const VAULT_PROVIDER_OFFSET = CURRENT_VAULT_OFFSET + 32;
+export const COLLATERAL_MINT_OFFSET = VAULT_PROVIDER_OFFSET + 1;
+
+// Obligation parsing
+export const BORROWS_OFFSET = 1208;
+export const BORROW_ENTRY_SIZE = 200;
+export const BORROWED_AMOUNT_SF_OFFSET = 88;
+
+// KVault remaining accounts (reserves + markets) for allez (A1USd…) vault operations.
+// Synced to the live vault_allocation_strategy: 10 active reserves in slot order,
+// followed by their lending markets (deduplicated). Re-derive with
+// scripts/get-vault-reserves.ts if the vault rebalances (adds/removes/reorders
+// reserves), or KVault deposit fails with ReserveAccountAndKeyMismatch (0x1b62).
+export const KVAULT_REMAINING_ACCOUNTS = [
+  // Reserves (writable)
+  { pubkey: new PublicKey("D6q6wuQSrifJKZYpR1M8R4YawnLDtDsMmWM1NbBmgJ59"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("Ga4rZytCpq1unD4DbEJ5bkHeUz9g3oh9AAFEi6vSauXp"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("9FRZvAsjDJ6WM8BJ2S45h9PoDCLAq8DNY9zZDX7MyGzT"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("8trJaNUfkP9pNgrwzByfsuwVtZ5TmZpq568UkCpjFWbi"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("8Lvi1DFPoAGPQ25qpRKzzRaSAnWdeVZqt9XmEapm8uLt"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("Atj6UREVWa7WxbF2EMKNyfmYUY1U1txughe2gjhcPDCo"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("9GJ9GBRwCp4pHmWrQ43L5xpc9Vykg7jnfwcFGN8FoHYu"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("DD4RN8t37nmw7EANW37ejdDEuFz9Tmf3TZTN7jxKsE8i"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("4QKFoFDzNFnvfkzVazABbCEfMwd3y1pZqUVzmpnkCphj"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("AYL4LMc4ZCVyq3Z7XPJGWDM4H9PiWjqXAAuuHBEGVR2Z"), isSigner: false, isWritable: true },
+  // Lending Markets (readonly)
+  { pubkey: new PublicKey("7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("DxXdAyU3kCjnyggvHmY5nAwg5cRbbmdyX3npfDMjjMek"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("GMqmFygF5iSm5nkckYU6tieggFcR42SyjkkhK5rswFRs"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("B7a2Dmdnfg8zfZX2814d6Xo6ctxs22jnTuCcjTq5KcPD"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("47tfyEG9SsdEnUm9cw5kY9BXngQGqu3LBoop9j5uTAv8"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("6WEGfej9B9wjxRs6t4BYpb9iCXd8CpTpJ8fVSNzHCC5y"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("CqAoLuqWtavaVE8deBjMKe8ZfSt9ghR6Vb8nfsyabyHA"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("FteaGMVCLDF4eonrTiQkRQ5kby5ohwCfaMD2mNiPkZL7"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("52FSGeeokLpgvgAMdqxyt5Hoc2TbUYj5b8yxrEdZ37Vf"), isSigner: false, isWritable: false },
+];
+
+// Prime vault batch accounts (4 reserves + 4 markets, verified from mainnet deposit txns)
+export const PRIME_BATCH_ACCOUNTS = [
+  { pubkey: ALTCOIN_USDC_RESERVE, isSigner: false, isWritable: true },
+  { pubkey: USDC_RESERVE, isSigner: false, isWritable: true },
+  { pubkey: JLP_USDC_RESERVE, isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("Atj6UREVWa7WxbF2EMKNyfmYUY1U1txughe2gjhcPDCo"), isSigner: false, isWritable: true },
+  { pubkey: ALTCOIN_MARKET, isSigner: false, isWritable: false },
+  { pubkey: MAIN_MARKET, isSigner: false, isWritable: false },
+  { pubkey: JLP_MARKET, isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("6WEGfej9B9wjxRs6t4BYpb9iCXd8CpTpJ8fVSNzHCC5y"), isSigner: false, isWritable: false },
+];
+
+// Rockaway batch accounts — 6 active reserves + 4 unique markets, synced to the
+// live vault_allocation_strategy (re-derive like KVAULT_REMAINING_ACCOUNTS above)
+export const ROCKAWAY_BATCH_ACCOUNTS = [
+  { pubkey: RWA_USDC_RESERVE, isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("4QKFoFDzNFnvfkzVazABbCEfMwd3y1pZqUVzmpnkCphj"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("AYL4LMc4ZCVyq3Z7XPJGWDM4H9PiWjqXAAuuHBEGVR2Z"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("9GJ9GBRwCp4pHmWrQ43L5xpc9Vykg7jnfwcFGN8FoHYu"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("8Lvi1DFPoAGPQ25qpRKzzRaSAnWdeVZqt9XmEapm8uLt"), isSigner: false, isWritable: true },
+  { pubkey: new PublicKey("6kmkjcVrp7RfyRBrfCoKbe6Wss3urVaaB1Lez5kSNHd1"), isSigner: false, isWritable: true },
+  { pubkey: RWA_MARKET, isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("52FSGeeokLpgvgAMdqxyt5Hoc2TbUYj5b8yxrEdZ37Vf"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("47tfyEG9SsdEnUm9cw5kY9BXngQGqu3LBoop9j5uTAv8"), isSigner: false, isWritable: false },
+  { pubkey: new PublicKey("CqAoLuqWtavaVE8deBjMKe8ZfSt9ghR6Vb8nfsyabyHA"), isSigner: false, isWritable: false },
+];

package/src/errors.ts

@@ -0,0 +1,33 @@
+// Shared error classification for Hobba SDK consumers (app, widget, headless).
+// Core's execute flows throw plain Errors with descriptive messages; consumers
+// call `classifyError` to map them onto stable codes for UI copy / telemetry.
+
+export type HobbaErrorCode =
+  | "WALLET_NOT_CONNECTED"
+  | "NOT_ALLOWLISTED"
+  | "SIMULATION_FAILED"
+  | "SEND_FAILED"
+  | "USER_REJECTED"
+  | "UNKNOWN";
+
+export class HobbaError extends Error {
+  code: HobbaErrorCode;
+  constructor(code: HobbaErrorCode, message: string, cause?: unknown) {
+    super(message);
+    this.name = "HobbaError";
+    this.code = code;
+    (this as any).cause = cause;
+  }
+}
+
+export function classifyError(e: any): HobbaError {
+  if (e instanceof HobbaError) return e;
+  const msg: string = e?.message ?? String(e);
+  let code: HobbaErrorCode = "UNKNOWN";
+  if (/wallet not connected/i.test(msg)) code = "WALLET_NOT_CONNECTED";
+  else if (/allowlist/i.test(msg)) code = "NOT_ALLOWLISTED";
+  else if (/user rejected|rejected the request|declined/i.test(msg)) code = "USER_REJECTED";
+  else if (/simulation failed/i.test(msg)) code = "SIMULATION_FAILED";
+  else if (/not confirmed|failed to send|blockhash/i.test(msg)) code = "SEND_FAILED";
+  return new HobbaError(code, msg, e);
+}