Vulcan Forge API
  1. Core Concepts
Vulcan Forge API
  • Introduction
  • Getting Started
  • Authentication & Authorization
  • Core Concepts
    • Terminology
    • Regulated Assets
    • Tenants
    • Mapping & Labelling
    • SVM Networks
    • Transaction Processing
    • Key Management
    • Read Layer
  • API Reference
    • Blockchain Accounts
      • Create Account
      • Fetch Account Details
      • Fetch Account Private Key
      • Fetch Account Balance
      • Fetch Accounts
      • Update Account
      • Inactivate Account
    • Financial Instruments
      • Create Financial Instrument
      • Fetch Financial Instrument Details
      • Fetch Financial Instrument Circulating Supply
      • Fetch Financial Instruments
      • Update Financial Instrument
      • Close Financial Instrument
      • Pause Financial Instrument
      • Unpause Financial Instrument
      • Token Extensions Calculator
    • Positions
      • State
        • Initialize Position
        • Update Position
        • Inactivate Position
        • Freeze Position
        • Unfreeze Position
      • Movements
        • Mint
        • Burn
        • Transfer Financial Instrument
        • Transfer Network Currency
      • Trades
        • Trade
      • History
        • Fetch Position Details
        • Fetch Position Balance
        • Fetch Positions
    • Loans
      • Create Loan
      • Fetch Loan Details
      • Fetch Loans
      • Swap Collateral
      • Repay Loan
      • Close Loan
      • Refinance Loan
    • 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
    • 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 Transaction Details
        • Fetch Transactions
  • Schemas
    • Accounts
      • DKG
        • DKG Key Setup
      • Max Allowed Debit Config
      • Offchain References
      • Account Lookup
      • New Account
      • Tenancy Config
      • Offchain File
      • Network Currency Debit Limit Config
      • Token Debit Limit Config
      • Limit Duration
    • Transactions
      • Svm Value Input
      • Svm Transaction Config
      • Commitment Config
      • Transaction Lookup
    • Query
      • Query Components
        • Sort Model
        • Filter Model
        • Field Value Filter
      • Items Query
      • Bulk Query
    • Loans
      • Loan Duration
    • Reponses
      • Errors
        • Individual Error
        • Error Response
      • Accounts
        • Private Keys
          • Database Private Key Details
          • Private Key Details
          • Cloud Provider Resource Location
          • DKG Private Key Details
        • Account Response Detailed
        • Account Onchain Detailed
        • Account Offchain Detailed
        • Account Response Compact
        • Account Onchain Compact
        • Account Offchain Compact
        • Account Response Identifiers
      • Transactions
        • Svm Value Result
        • Svm Transaction Result
        • Svm Entity Result
      • Financial Instruments
        • Financial Instrument Detailed
        • Financial Instrument Compact
        • Financial Instrument Identifiers
      • Loans
        • Loan Response
      • Positions
        • Position Offchain Result
        • Position Balance Response
        • Position Response Detailed
        • Position Response Compact
        • Position Response Identifiers
      • Market Data
        • Onchain Data Source Response
    • Positions
      • Position Lookup
      • Mint Definition
      • Burn Definition
      • Transfer Financial Instrument Definition
      • Transfer Network Currency Definition
    • Market Data
      • Onchain Data Source Details
      • Switchboard details
    • Loans
  1. Core Concepts

Tenants

TLDR#

The highest level concept representing a client to Vulcan Forge. Models and supports the complexities of a financial institution, regardless of its size.

Who uses Vulcan Forge#

As a multi-tenant software-as-a-service platform, Vulcan Forge allows the concurrent usage of its API endpoints by multiple financial institutions by providing clear separation of data associated with and used by each tenant.
There are 3 types of tenants supported by Vulcan Forge:
1.
Multi-org Tenants - Tenants which have a designated parent/root organization and a set of sub-organizations sitting directly underneath it.
2.
Single-org Tenants - Tenants which are setup with a single organization.
3.
The System Tenant - A default tenant created at Vulcan Forge's inception which performs special functions shared across the entire platform.
Alphaledger with its entities was the first non-system tenant which uses Vulcan Forge. Alphladeger issues onchain funds (e.g. T12 offered through its investor platform: Dominium).
Organizations onboarded in Alphaledger's tenant:
ALG -> Alphaledger Group - the parent org
ALIM -> Alphaledger Investment Management - the org that manages the issuance and onchain management of new funds through Vulcan Forge
DOM -> Dominium - an org that groups the investors' accounts which hold financial instruments issued by ALIM
The diagram below reflects the 3 flavors of tenants and their relationship to Vulcan Forge.

System Tenant Responsabilities#

The Vulcan Forge System (VFS) tenant peforms the following functions:
It onboards blockchain entities that are to be shared across tenants; it is the only tenant that can do so. Examples:
accounts for system prgrams and popular protocol programs
stablecoin tokens: USDC, PYUSD, etc
other frequently traded tokens that multiple VF tenants are interested in interacting with
oracle authorities and queues
Operates the Vulcan Forge Ingestor - a middlware component which listens to real-time network events pushed through the RPC provider and ingests transactions which involve blockchain accounts onboarded on the platform (regardless of which tenant they belong to) and setup with subscribeToNetworkEvents=true
Go here for more details related to on vs off platform blockchain accounts.

Tenants and offchain references#

The diagram below expounds how offchain references, used very frequently through most of the API endpoints, fit within a tenant's hierarchy.
alIds - map to financial instruments
organizationExternalIds & accountNumbers - map to the rest of blockchain entities (with Wallets being frequently mapped to accountNumbers)
Each organization has its own API Key(s) issued to it.
More details on the offchain references and blockchain account types can be found here.

Creation of offchain references#

1.
organizationExternalId(s) are 3-4 character codes assigned at the time a tenant signs-up to use Vulcan Forge
2.
alIds and accountIds:
a. can be created by Alphledger staff and assigned to the tenant
b. generated automatically if not supplied at account/blockchain entity creation
c. a separate set of API endpoints for setting up of Offchain Entities.
Option a. is available now, while b. and c. will be made available in the near future.
Modified at 2026-03-08 15:37:31
Previous
Regulated Assets
Next
Mapping & Labelling
Built with