Expand description
§Noviscia Asset Engine SDK
Instruction builders + PDA derivation for the noviscia-asset-engine on-chain program — the multi-asset token register & pool layout.
Three standardized SPL profiles share one engine: SOL arrives as wSOL
(Same decimals as native SOL, handled identically to any SPL asset), USDC,
and the NVSC project token. Each asset owns a segregated AssetPool with
its own capacity ceiling, premium baseline, and vault pair.
Flagship builders:
build_allocate_asset_capacity_ix— single-slot JIT allocation that verifies Merkle KYC, opens/rolls the 24h floating window, and atomically CPIs the principal (the micro-premium is accrued, taxi-meter style).build_settle_daily_ix— daily Clearing House settlement: the desk treasury returns the exact native asset and the ledger resets.build_recredit_asset_capacity_ix— releases unused slot capital back into the pool.build_register_asset_ix— onboards a mint into the token register.
Modules§
- economics
- Quantified Risk Pack & Economics — Module 1 of the TVV risk engine
- velocity
- Total Value Velocity (TVV) Specification Sheet — Module 2 of the TVV
Structs§
- Asset
Engine Registry - Global asset engine configuration — stores the three-tier Layered Governance multi-sig keys (Squads PDAs) that gate every authority path.
- Asset
Params - Per-asset plan used by
asset_register. - Asset
Pool - Per-mint pool profile: liquidity, premium params, and capacity ceiling.
- Desk
Position - Per-desk borrow mirror for one mint — principal out + settled premiums.
- Institutional
Credit Line - Aggregate institutional multi-asset credit ceiling + 24h floating window.
Enums§
- Window
Posture - Deterministic posture of the desk’s 24h floating window at
current_slot.
Constants§
- NVSC_
PROFILE - Standard NVSC project-token profile (9 decimals, VAULT-scale tokens, no min premium).
- USDC_
PROFILE - Standard USDC profile (6 decimals, fast-cash pool, tighter ceiling).
- WSOL_
PROFILE - Standard wSOL profile (9 decimals, native-interop).
Functions§
- anchor_
discriminator - First 8 bytes of
sha256("global:<name>")— Solana’s built-in SHA-256. - asset_
authority_ pda - asset_
fee_ vault_ pda - asset_
lp_ mint_ pda - ERC-4626 share-mint per pool:
[asset-lp-mint, mint](nUSDC / nSOL / nNVSC). - asset_
lp_ position_ pda - Per-(pool, LP) share-position ledger:
[asset-lp-position, mint, lp]. - asset_
pool_ pda - asset_
register_ default - asset_
vault_ pda - build_
allocate_ asset_ capacity_ ix - Build
asset_allocate_capacity— the Multi-Asset JIT Allocation core. - build_
deposit_ asset_ liquidity_ ix - Build
asset_deposit_liquidity— LP seeds a pool vault in native asset and receives freshly minted ERC-4626 share tokens (nUSDC / nSOL / nNVSC). - build_
initialize_ credit_ line_ ix - Build
asset_initialize_credit_line— registers an institution’s aggregate multi-asset credit ceiling (Tier 2: Risk Committee, 3-of-5, post-KYB). - build_
initialize_ ix - Build
initialize— pins the platform mints + guard authority. - build_
recredit_ asset_ capacity_ ix - Build
asset_recredit_capacity— releases unused slot capital. - build_
register_ asset_ ix - Build
asset_register— onboards a mint (Tier 3: Core Ecosystem Council, 5-of-7 Squads, 72h timelock). - build_
set_ asset_ support_ ix - Build
asset_set_support— toggles an asset’s registration latch (Tier 2: Risk Committee, 3-of-5 Squads). - build_
set_ credit_ frozen_ ix - Build
asset_set_credit_frozen— freezes an institution’s credit line (Tier 1: Emergency Risk Guard “The Breaker”, 1-of-3 Squads). - build_
set_ kyc_ root_ ix - Build
asset_set_kyc_root— posts a desk’s provider-agnostic Merkle root. Buildasset_set_kyc_root— provider-agnostic Merkle KYC root for a desk (Tier 2: Risk Committee, 3-of-5 Squads). - build_
set_ paused_ ix - Build
asset_set_paused— engine-level allocation pause (Tier 1: Emergency Risk Guard “The Breaker”, 1-of-3 Squads). - build_
settle_ daily_ ix - Build
asset_settle_daily— Phase 3 daily clearing house settlement. - build_
update_ asset_ params_ ix - Build
asset_update_params— adjusts a registered asset’s parameters (Tier 2: Risk Committee, 3-of-5 Squads). - build_
update_ credit_ limit_ ix - Build
asset_update_credit_limit— adjusts the aggregate ceiling (Tier 2: Risk Committee, 3-of-5 Squads). - build_
withdraw_ asset_ fees_ ix - Build
asset_withdraw_fees— sweeps a per-asset fee vault. Buildasset_withdraw_fees— sweeps a per-asset fee vault (Tier 3: Core Ecosystem Council, 5-of-7 Squads, 72h timelock — treasury allocation). - build_
withdraw_ asset_ liquidity_ ix - Build
asset_withdraw_liquidity— an LP burns share tokens and redeems a proportional slice of the pool vault, subject to the desk-solvency floor (idle − shares_value ≥ active credit utilization). - compute_
deposit_ shares - ERC-4626 deposit: shares minted for
depositat the current share price. MirrorsAssetPool::compute_deposit_shareson-chain; 1:1 on first deposit. - compute_
late_ fee - Per-block default-interest meter for the 2h grace phase (mirrors the
on-chain formula exactly).
overdue_blockscounts slots past the 24h maturity; zero once the window is still open. - compute_
lp_ share_ price - Scaled per-share price (×1_000_000) — the auto-compounding readout.
- compute_
lp_ withdraw_ value - ERC-4626 redeem: native assets returned for
sharesat the current price. MirrorsAssetPool::compute_lp_withdraw_valueon-chain (caps at assets). - compute_
premium - Compute the on-chain micro-premium for an allocation.
- credit_
line_ pda - desk_
position_ pda - Per-mint desk borrow mirror:
[desk-position, institution, mint]. - register_
wsol_ default - One-shot pointer to the wSOL-mint profile (native-interop).
- registry_
pda - window_
posture