Vulcan Forge
  1. Core Concepts
Vulcan Forge
  • Introduction
  • Getting Started
  • Authentication & Authorization
  • Core Concepts
    • Terminology
    • Regulated Assets
    • Tenants
    • Mapping & Labelling
    • Solana Networks
    • Transaction Processing
    • Key Management
    • Read Layer
  • API Reference
    • Blockchain Accounts
      • Create Account
      • Fetch Account Details
      • Fetch Account Balance
      • Fetch Account Private Key
      • Fetch Accounts
      • Update Account
      • Inactivate Account
    • Financial Instruments
      • Create Financial Instrument
      • Fetch Financial Instrument Details
      • Fetch Financial Instruments
      • Update Financial Instrument
      • Token Extensions Calculator
    • Positions
      • State
        • Initialize Position
        • Update Position
        • Close Position
        • Freeze Position
        • Unfreeze Position
      • Movements
        • Mint
        • Burn
        • Transfer Financial Instrument
        • Transfer SOL
      • Trades
        • Trade
      • History
        • Fetch Positions
        • Fetch Position Details
        • Fetch Position Balance
    • Loans
      • Create Loan
      • Fetch Loan Details
      • Fetch Loans
      • Swap Collateral
      • Repay Loan
      • Close Loan
      • Refinance Loan
    • Blockchain Transactions
      • Processing
        • Fetch Transaction Status
        • Sign Transaction
        • Submit Transaction
      • Durable Nonces
        • Create Durable Nonce Accounts
        • Fetch Durable Nonce Account Details
        • Fetch Durable Nonce Accounts
      • Address Lookup Tables
        • Create Address Lookup Table
        • Fetch Address Lookup Table Details
        • Fetch Address Lookup Tables
        • Extend Address Lookup Table
        • Update Address Lookup Table
      • History
        • Fetch Transactions
        • Fetch Transaction Details
    • Market Data
      • Onchain Data Sources
        • Create Onchain Data Source
        • Update Oracle Data Source Definition
        • Refresh Oracle Data Source
        • Fetch Onchain Data Source Details
        • Fetch Oracle Data Sources
  • Schemas
    • Accounts
      • DKG
        • DKG Key Setup
      • Offchain References
      • Account Lookup
      • New Account
      • Debit Limit Config
      • Limit Duration
      • Tenancy Config
      • Account Debits Config
      • Account Balance
      • Offchain File
    • Transactions
      • Solana Transaction Config
      • Commitment Config
      • Transaction Lookup
    • Query
      • Query Components
        • Sort Model
        • Field Value Filter
        • Filter Model
      • Items Query
      • Bulk Query
    • Loans
      • Loan Duration
    • Reponses
      • Errors
        • Individual Error
        • Error Response
      • Accounts
        • Private Keys
          • Private Key Details
          • Database Private Key Details
          • Cloud Provider Resource Location
          • DKG Private Key Details
        • Account Response Detailed
        • Account Onchain Detailed
        • Account Offchain Detailed
        • Account Response Identifiers
        • Account Offchain Compact
        • Account Response Compact
        • Account Onchain Compact
      • Financial Instruments
        • Financial Instrument Detailed
        • Financial Instrument Compact
        • Financial Instrument Identifiers
      • Transactions
        • Solana Transaction Result
        • Solana Entity Result
      • Positions
        • Position Offchain Result
        • Position Balance Response
        • Position Response Detailed
        • Position Response Compact
        • Position Response Identifiers
      • Loans
        • Loan Response
      • Market Data
        • Onchain Data Source Response
    • Positions
      • Position Lookup
      • Transfer SOL Definition
      • Transfer Financial Instrument Definition
      • Burn Definition
      • Mint Definition
      • Position Debits Config
      • Position Balance
    • Loans
    • Market Data
      • Onchain Data Source Details
      • Switchboard details
  1. Core Concepts

Terminology

TLDR#

Let it all be understood by everyone. We try our best at that.

Terms#

The following DeFi/TradFi terms are used interchangeably throughout the documentation and API reference.
DeFi TermTradFi TermDescription
TokenFinancial InstrumentThe master file definition of a tradeable item
Solana AccountBlockchain Account/EntityAside from transactions/instructions, everything else in Solana is an Account: programs, wallets, tokens, token accounts, authorities, etc.
WalletAccountA wallet is the closest representation to a traditional Account at a financial insituttion
Token AccountPositionAn entity that holds the balance of a financial instrument held in a TradFi account/DeFi wallet
RWARegulated AssetsThe life cycle of real-world assets and their exchange of ownership most of the times require the visibility into/oversight of at least some sort of a regulatory entity and cannot be done fully permissionlessly and/or without any reporting requirements
ThawUnfreezeThe process of removing restrictions over the movement of assets
OracleOnchain Data SourceA blockchain account holding data to be used by onchain programs and periodically refreshed with data from offchain locations
CuratorRisk ManagerEntity or person in charge with evaluating risk parameters for an onchain lending pool and make adjustments necessary to maintain the health of loans within allowed limits

Why not only DeFi terms?#

We tend to use more often the TradFi terms not only because they are more widely understood but also because we think they are a better representation of the concepts they convey.
Additional reasons for these naming decisions:
Token does not do enough justice to all the type of items that can be traded/settled on a blockchain.
Token is a good term if one mostly wants to convey simplicity (a price, a symbol and a logo) and speculation
Financial instrument is a more generic and encompassing term. Aside from tokens, it can also include RWA tradeable instruments with much more complex/rich master file definitions and life cycles
Token Account is a confusing term for someone coming new to Solana: is this the master file for a token? No? And btw, what is a mint account? Something related to minting tokens? Ah, no - that is the masterfile representation. And where do I see the balances of what I own?
Position has been used for decades and it clicks with anyone involved in trading/finance
Some of the naming choices could be viewed as more pedantic. Like the use of unfreeze vs thaw - after all these terms are very much synonyms. We use though unfreeze because that is what we have seen being used a lot more often within a financial context.
We would not mind to see the Token Account term go away. But otherwise we have no expectation and desire to replace well entreched DeFi terms with those we propose. After all crypto tokens have their place too in finance. We just want to be more clear and easily understood in the communication with our customers, regardless if they know much or not about blockchains.

Meaning for Onboarding#

What does it mean to onboard a blockchain entity into Vulcan Forge?
It means to use one of a Create API endpoint to setup the blockchain entity in:
the offchain Vulcan Forge database
optionally, onto the Solana Network (if that entity did not exist onchain already)
Look for Onboarding Endpoint=Yes label in the API Reference to find those Create endpoints that can be used for onboarding.
The alreadyOnchain field part of these endpoints' request body controls this behavior. Note that if the onboarding of an entity is done with alreadyOnchain=true, the entity has to actually already exist onchain (the system verifies that). The corollary to this is that every entity that gets created into the Vulcan Forge offchain database has to have a public key address. And uniqueness rules are enforced at creation time.
Modified at 2025-12-15 14:12:38
Previous
Authentication & Authorization
Next
Regulated Assets
Built with