The collateral onboarding and offboarding workflow defines the end-to-end process for altering the set of assets that back the Synthetix debt pool. This is not merely a governance vote; it is a multi-phase operational sequence involving risk assessment, oracle integration, parameter configuration, and a controlled rollout. Each step is designed to ensure that a new collateral type does not introduce systemic risk to the shared debt pool and that a deprecated asset can be removed without triggering unintended liquidations or market disruptions.

Collateral Onboarding and Offboarding Workflow
Introduction
The formal operational playbook for introducing new collateral types to the Synthetix system and responsibly retiring deprecated ones.
The workflow begins with a quantitative risk assessment that models the asset's volatility, liquidity, and correlation with existing collateral. This analysis directly informs the configuration of critical parameters such as issuance ratio, liquidation ratio, and any applicable haircuts. Following governance approval, the technical integration phase requires a reliable Chainlink or Pyth price feed with verified staleness thresholds and circuit breaker logic. The final stage is a phased rollout, often starting with a capped debt ceiling that is gradually increased as the system demonstrates stability under live market conditions.
For offboarding, the process is equally rigorous. A deprecated asset must have its debt ceiling reduced to zero, preventing new issuance, while existing positions are given a clear timeline to migrate or close. Protocol operators and risk teams must actively monitor vault health during this period to manage the risk of a liquidity crunch. A failure to follow this structured workflow can lead to mispriced collateral, bad debt accrual, and a loss of confidence in the system's solvency. Chainscore Labs provides independent review and implementation support for teams navigating this high-stakes process.
Quick Facts
Operational facts about the collateral onboarding and offboarding workflow to help risk teams, governance participants, and integrators assess process integrity and integration impact.
| Area | What changes | Who is affected | Action |
|---|---|---|---|
Governance authority | Spartan Council votes to approve or reject collateral types via SCCP | Governance delegates, stakers, risk teams | Review SCCP justification and risk assessment before voting |
Risk assessment | New collateral requires liquidity, volatility, and oracle support analysis | Risk managers, protocol operators | Validate risk model parameters against independent data sources |
Oracle integration | A reliable price feed must be established with acceptable staleness and deviation thresholds | Oracle providers, integrators, keepers | Verify feed address, heartbeat, and circuit breaker configuration on each deployed chain |
Parameter configuration | Collateral-specific caps, issuance ratios, and liquidation ratios are set | Governance participants, risk teams, liquidators | Simulate vault behavior under extreme volatility before mainnet activation |
Phased rollout | Collateral is typically activated with conservative caps that are gradually increased | Stakers, arbitrageurs, integrators | Monitor vault health metrics and utilization during each phase |
Offboarding trigger | Collateral can be deprecated due to liquidity loss, oracle failure, or governance decision | Stakers with open positions, liquidators, integrators | Track offboarding announcements and prepare to migrate or close positions |
Offboarding execution | Existing positions are subject to a wind-down period with restricted minting before final settlement | Stakers, keepers, front-end interfaces | Update UI and liquidation bots to handle deprecated collateral status |
Integration impact | Adding or removing a collateral type changes vault accounting, event schemas, and API responses | Indexers, data providers, wallets, exchanges | Test subgraph and event parsing logic against testnet deployment before mainnet activation |
V3 Collateral Architecture and Integration Points
A technical breakdown of the Synthetix V3 vault-and-pool architecture, detailing how collateral assets are isolated, valued, and integrated to inform the risk assessment and parameter configuration phases of the onboarding workflow.
Synthetix V3 fundamentally restructures the protocol's financial backbone by replacing the monolithic V2x debt pool with a modular architecture of discrete, isolated vaults. Each collateral type—such as sUSDC, sETH, or a stablecoin LP token—is deposited into its own dedicated vault, which is then delegated to one or more pools to provide liquidity for specific markets like perps or spot. This design is the critical context for the collateral onboarding workflow: adding a new asset is not merely a parameter tweak but the deployment of a new vault contract that must be securely integrated with the pool delegation, reward distribution, and liquidation systems.
From an operational perspective, the integration points for a new vault are extensive. The vault's oracle configuration must be aligned with the NodeModule to define a price feed, which can be a direct Chainlink or Pyth node or a more complex aggregation of multiple sources. The CollateralModule then uses this price to enforce the vault's specific issuance ratio and minimum collateralization ratio (c-ratio). Crucially, the vault's liquidation logic is not a global setting; it is configured per vault, meaning the onboarding process must explicitly define the liquidation reward, the keeper flagging window, and the account health calculation method. A misconfiguration here can create an unbacked debt position or a vault that is economically unviable for liquidators to service.
For builders and integrators, the V3 architecture means that the interface for interacting with collateral is no longer a single proxy. A new vault's address must be registered in the VaultModule and its associated pool delegations set via the PoolModule. Wallets, exchanges, and front-ends that track user positions must update their indexing logic to monitor the new vault's CollateralDeposited and CollateralWithdrawn events. Before a governance vote to onboard a new collateral type, a thorough review of these integration points—from the oracle node definition to the liquidation parameter tuning and event schema compatibility—is essential to prevent a fragmented user experience or a solvency risk. Chainscore Labs can provide an independent readiness review of this entire configuration before it goes to a Spartan Council vote.
Affected Actors and Systems
Governance and Risk Teams
Spartan Council members and risk stewards are the primary decision-makers. They must evaluate the risk profile of a new asset, including its volatility, liquidity, and oracle support, before initiating a vote.
Action Steps:
- Commission a third-party risk assessment for the proposed collateral type.
- Review the proposed parameters (issuance ratio, liquidation ratio, cap) against historical market stress scenarios.
- Coordinate with the treasury council to ensure the protocol can absorb the new risk without threatening the debt pool's solvency.
- Monitor the phased rollout and be prepared to pass an emergency SCCP to cap or offboard the asset if anomalies are detected.
Phased Rollout and Implementation Impact
A structured, multi-phase process for integrating new collateral types or deprecating existing ones is critical to prevent solvency shocks, oracle manipulation, and keeper failures. Each phase introduces specific operational and integration requirements that teams must address.
Risk Parameter Calibration and Simulation
Before any on-chain proposal, risk teams must define and rigorously backtest parameters including the issuance ratio, liquidation ratio, and minimum collateralization ratio. Simulations should model the asset's volatility profile against the debt pool's composition to prevent a single collateral type from becoming an existential solvency risk. Chainscore Labs can provide an independent review of the parameter methodology and stress-testing scenarios to validate the asset's behavior under extreme market drawdowns.
Oracle Integration and Circuit Breaker Configuration
Onboarding requires integrating a robust, manipulation-resistant oracle feed from providers like Chainlink or Pyth. The implementation must configure staleness thresholds, deviation circuit breakers, and fallback logic within the Synthetix aggregation contract. A misconfigured oracle for a new, potentially illiquid asset can lead to invalid liquidations or allow toxic order flow. Integrators must verify the feed's heartbeat and deviation parameters against the asset's expected on-chain trading frequency.
Keeper Network Readiness and Liquidation Testing
The introduction of a new collateral type requires keeper bots to update their liquidation logic to recognize the new vault contract and asset-specific liquidation parameters. Operators must conduct integration testing on a testnet to ensure keepers can successfully flag under-collateralized positions and execute liquidations without reverting. A failure in keeper readiness can lead to a buildup of bad debt immediately upon collateral activation, threatening the sUSD peg.
Phased Activation and Debt Cap Management
Collateral should be introduced with a conservative, time-bound debt cap that is gradually increased by governance as the system proves its stability. This limits the protocol's exposure during the initial observation period. Risk managers must actively monitor the minting velocity against the cap and be prepared to propose an emergency cap reduction via an SCCP if anomalous borrowing patterns or oracle deviations are detected during the early phases of the rollout.
Frontend and Integrator Migration for Deprecation
Offboarding a collateral type is an active process that requires clear communication of the end-of-life schedule. Integrators, wallets, and front-end interfaces must update their UIs to prevent new deposits and prominently warn users to repay debt and withdraw collateral before the final shutdown. Failing to coordinate this migration traps user funds in deprecated contracts and creates a negative user experience that requires manual, governance-led recovery interventions.
Risk Matrix and Mitigation Controls
Key risks introduced or mitigated at each stage of the collateral onboarding and offboarding workflow, with affected parties and recommended actions.
| Area | What changes | Who is affected | Action |
|---|---|---|---|
Risk Assessment | New risk model for a novel asset class is introduced; incomplete analysis could misprice systemic risk. | Governance delegates, Risk teams, Spartan Council | Review risk model assumptions against historical volatility and liquidity data. Verify against canonical source. |
Oracle Setup | A new price feed is integrated or an existing feed is deprecated; stale or manipulated data could trigger false liquidations. | Oracle providers, Perps integrators, Liquidation keepers | Validate feed deviation thresholds, heartbeat, and aggregation logic on testnet. Monitor for staleness post-launch. |
Parameter Configuration | Collateral-specific parameters (issuance ratio, haircut) are set; overly aggressive parameters can cause premature liquidations. | Stakers, Borrowers, Liquidation engine operators | Simulate vault health under extreme market drawdowns before governance vote. Request a parameter review from Chainscore Labs. |
Phased Rollout | Collateral cap is gradually increased; a rapid increase could concentrate debt-pool risk in an untested asset. | Debt pool hedgers, sUSD arbitrageurs, Risk teams | Monitor global collateralization ratio and debt pool skew during each cap increase. Set automated alerts for concentration thresholds. |
Integration Activation | New collateral is enabled in core contracts; a faulty proxy upgrade or interface mismatch can break composability. | Wallets, Front-ends, Aggregators, Custodians | Test all user flows (deposit, mint, burn, withdraw) against the new contract addresses on a staging environment. |
Offboarding Announcement | A collateral type is marked for deprecation; delayed user action can lead to forced redemption at unfavorable rates. | Borrowers, Stakers, Exchange teams | Notify users with clear deadlines and migration paths. Monitor vault repayment rates leading up to the offboarding deadline. |
Oracle Deprecation | Price feed for a deprecated collateral is removed; stale data could freeze remaining positions. | Liquidation keepers, Protocol operators | Ensure circuit breakers trigger a graceful halt for affected vaults before the feed is deactivated. Verify against canonical source. |
Legacy Contract Sunset | Core logic for a deprecated collateral is removed; any remaining locked funds could become permanently inaccessible. | Integrators, Indexers, Data teams | Audit all dependent contracts and subgraphs for calls to the deprecated logic. Execute a final sweep of residual funds before deactivation. |
Operator and Governance Checklist
A structured checklist for protocol operators, risk teams, and governance participants to validate readiness before a new collateral type is onboarded or an existing one is deprecated. Each step confirms that risk, oracle, and parameter dependencies are resolved to prevent integration failures or solvency threats.
What to check: A formal risk assessment has been completed and published, covering the asset's liquidity profile, volatility history, smart contract risk, and correlation with existing collateral.
Why it matters: The shared debt pool means that a failure in a single collateral type can dilute all stakers. The assessment must justify the proposed parameters (issuance ratio, liquidation ratio, haircut) and define the maximum debt exposure.
Readiness signal: The risk assessment document is linked in the governance proposal, and the proposed parameters are explicitly mapped to specific risk metrics (e.g., 30-day historical volatility, on-chain liquidity depth).
Canonical Resources
Use these sources to verify the current state of Synthetix collateral onboarding or offboarding work before changing integrations, risk limits, monitoring rules, or production runbooks.
Looking to build on a specific blockchain?
We build smart contracts, DeFi applications, wallets, tokenization platforms, and blockchain infrastructure across the major ecosystems teams choose today. That includes Ethereum, Arbitrum, Optimism, Polygon, Avalanche, Solana, Sui, Aptos, Hedera, Stellar, and NEAR, with support for additional EVM and non-EVM networks based on your product requirements.
EVM ecosystems
- Ethereum
- Arbitrum
- Optimism
- Polygon
- Avalanche
- Cronos

Non-EVM ecosystems
- Solana
- Sui
- Aptos
- Hedera
- Stellar
- NEAR
Additional ecosystems
- Polkadot
- Cosmos
- TON
- Cardano
- Algorand
- Tempo
Also available for Base, appchains, custom EVM networks, and cross-chain product architecture.
Frequently Asked Questions
Common operational questions from protocol operators, risk teams, and governance participants managing the end-to-end collateral onboarding and offboarding workflow.
The process begins with a risk assessment and community proposal, typically formalized as an SCCP (Synthetix Configuration Change Proposal). The proposal must include:
- Asset liquidity profile: On-chain depth, CEX volume, and historical volatility data.
- Oracle feasibility: Confirmation that a robust Chainlink or Pyth price feed exists or can be commissioned.
- Risk parameter recommendations: Proposed issuance ratio, liquidation ratio, and any haircut or cap.
Teams should not proceed to testnet deployment until the Spartan Council signals intent to vote on the SCCP. Chainscore Labs can review the risk parameter justification and oracle dependency model before the proposal reaches governance.
Delivering blockchain solutions for 5+ years.
We have partnered with 50+ leading DeFi protocols, NFT ecosystems, and fintech innovators to build secure, scalable, and capital-efficient blockchain products.
Selected Partners & Clients
“I've been working with Chainscore Labs for last 3+ years, they've consistently delivered with strong ownership across multiple projects. The team is reliable and detail-oriented.”
How to get started?
If you're looking for blockchain integration, ChainScore Labs has 5+ years of experience helping teams build and integrate exchanges, wallets, smart contracts, tokenization solutions, and protocol-connected products, we can help you choose the right path, integrate securely, and get to production faster. Our team consists of experienced blockchain developers and architects who can help you with your blockchain integration needs.
Exploration & Strategy
Define your product goals and choose the right blockchain architecture for your use case.
Architecture & Design
Design the smart contracts, tokenomics, and security parameters of your system.
Development & Integration
Build and integrate with wallets, oracles, and front-end dApps for a seamless experience.
Security & Launch
Comprehensive audits followed by a risk-managed mainnet deployment to protect your users.
Discover our
blockchain development services.
We build production-grade blockchain solutions for top-tier projects across DeFi and Web3.
Need a blockchain engineering team?
Send the project context and we will respond with next steps, scope questions, and a practical path to delivery.


