Intenus General Standard
IGS Schema
Purpose
The Intenus General Standard (IGS) is a comprehensive schema that standardizes how intents, solutions, and execution data are represented across the entire protocol. Think of it as a universal language that all system components understand.
Why Standardization Matters
Interoperability: Different solvers, AI models, and smart contracts can seamlessly communicate
Extensibility: New intent types can be added without breaking existing functionality
Verifiability: Standardized formats enable deterministic verification of solutions
Clarity: Unambiguous representation prevents misinterpretation
IGS Structure
The IGS framework consists of three layers:
1. Core Primitives
Foundational data types used throughout the protocol:
{
"SuiAddress": "0x...",
"TokenAmount": "1000000000",
"Timestamp": 1699123456000,
"Signature": "0x..."
}Purpose: Eliminates ambiguity in basic data representation Examples: Addresses, amounts, time values, signatures
2. Intent Specification
Structured representation of user trading goals:
{
"igs_version": "1.0.0",
"intent_type": "swap.exact_input",
"operation": {
"mode": "exact_input",
"inputs": [{
"asset_id": "0x2::sui::SUI",
"amount": {"type": "exact", "value": "1000000000"}
}],
"outputs": [{
"asset_id": "0x...::usdc::USDC",
"amount": {"type": "range", "min": "950000", "max": "1000000"}
}]
},
"constraints": {
"max_slippage_bps": 50,
"deadline_ms": 1699123456000
},
"privacy": {
"encryption_required": true,
"solver_access_window_ms": 300000
}
}Key Features:
Flexible amount types (exact, range, percentage)
Comprehensive constraint system
Privacy policy integration
Support for complex multi-asset operations
3. Solution Specification
Standardized format for solver proposals:
{
"solution_id": "sol_abc123",
"intent_id": "int_xyz789",
"solver_address": "0x...",
"execution_plan": {
"steps": [
{
"protocol": "Cetus",
"action": "swap",
"params": {...}
}
],
"total_gas_estimate": "500000"
},
"expected_outcomes": {
"output_amount": "995000",
"execution_time_ms": 5000,
"slippage_bps": 30
},
"solver_commitment": {
"signature": "0x...",
"stake_locked": "10000000000"
}
}Supported Intent Types
Swap Intents
exact_input: Specify input amount, optimize output
exact_output: Specify output amount, minimize input
range_swap: Flexible amounts within ranges
Limit Order Intents
limit_buy: Execute purchase at target price
limit_sell: Execute sale at target price
stop_loss: Trigger sale below threshold
take_profit: Trigger sale above threshold
Lending Intents
lend: Deposit assets for yield
borrow: Take loans against collateral
repay: Pay back borrowed assets
optimize_yield: Automatically rebalance
Bridge Intents
cross_chain_transfer: Move assets between chains
liquidity_bridge: Optimized cross-chain liquidity
Composite Intents
multi_step: Sequential operations
conditional: If-then logic
batch: Multiple parallel operations
Version Management
IGS uses semantic versioning:
Major: Breaking changes to schema structure
Minor: Backward-compatible additions
Patch: Bug fixes and clarifications
Current version: 1.0.0
Last updated