IGS Core
Foundation of Standardization
IGS Core defines the primitive data types and foundational schemas used throughout the Intenus Protocol. Think of it as the "dictionary" that ensures everyone speaks the same language.
Core Schema Reference
Schema Overview
SolutionSubmission
Solution submitted by solver (on-chain reference)
IntentClassification
Intent classification result from ML classifier
PreRankingResult
PreRanking engine result - validation, classification, and feature extraction
RankedSolution
Ranked solution with scoring and explanation
RankingResult
Ranking engine final result
SolutionSubmission
solution_id
string
Unique solution ID (from on-chain object)
intent_id
string
Intent ID this solution is for
solver_address
string
Solver's blockchain address
submitted_at
number
Submission timestamp (Unix ms)
blob_id
string
Tx transaction bytes reference
IntentClassification
primary_category
string
Primary detected intent category
primary_category_confidence
number
Primary category confidence (0-1)
detected_priority
string
User priority detected from constraints
detected_priority_confidence
number
Priority detection confidence (0-1)
complexity_level
string
Intent complexity level
complexity_level_confidence
number
Complexity confidence (0-1)
risk_level
string
Risk assessment level
risk_level_confidence
number
Risk level confidence (0-1)
strategy
string
Detected optimal strategy
strategy_confidence
number
Strategy confidence (0-1)
weights
object
Ranking weights object
Primary Category Values
swap
Token swap operation
limit_order
Limit order execution
complex_defi
Complex DeFi strategy
arbitrage
Arbitrage opportunity
other
Other intent type
Detected Priority Values
speed
Speed-focused priority
cost
Cost-focused priority
output
Output-focused priority
balanced
Balanced priority
Complexity Level Values
simple
Simple operation
moderate
Moderate complexity
complex
High complexity
Risk Level Values
low
Low risk assessment
medium
Medium risk assessment
high
High risk assessment
Weights Object
gt_weight_surplus_usd
number
Weight for surplus in USD
gt_weight_surplus_percentage
number
Weight for surplus percentage
gt_weight_gas_cost
number
Weight for gas cost
gt_weight_protocol_fees
number
Weight for protocol fees
gt_weight_total_hops
number
Weight for total routing hops
gt_weight_protocols_count
number
Weight for number of protocols
gt_weight_estimated_execution_time
number
Weight for execution time
gt_weight_solver_reputation_score
number
Weight for solver reputation
gt_weight_solver_success_rate
number
Weight for solver success rate
PreRankingResult
intent_id
string
Intent ID being processed
intent_classification
IntentClassification
Intent classification result
passed_solution_ids
array
Solution IDs that passed validation
failed_solution_ids
array
Failed solutions with reasons
feature_vectors
array
Solution feature vectors
dry_run_results
array
Simulation results
stats
object
Processing statistics
processed_at
number
Processing timestamp (Unix ms)
Failed Solution Item
solution_id
string
Solution identifier
failure_reason
string
Reason for failure
errors
array
Error details array
Feature Vector Item
solution_id
string
Solution identifier
features
object
Feature data object
Features Object
surplus_usd
number
Surplus value in USD
surplus_percentage
number
Surplus as percentage
gas_cost
number
Gas cost estimate
protocol_fees
number
Protocol fees total
total_cost
number
Total execution cost
total_hops
number
Number of routing hops
protocols_count
number
Number of protocols used
estimated_execution_time
number
Estimated execution time
solver_reputation_score
number
Solver reputation score
solver_success_rate
number
Solver historical success rate
Dry Run Result Item
solution_id
string
Solution identifier
result
object
Raw simulation result from Sui
Stats Object
total_submitted
number
Total solutions submitted
passed
number
Number that passed validation
failed
number
Number that failed validation
dry_run_executed
number
Number of dry runs executed
dry_run_successful
number
Number of successful dry runs
RankedSolution
rank
number
Ranking position (1 = best)
score
number
Overall score (0-100)
solution_id
string
Solution ID reference
solver_address
string
Solver address
transaction_bytes
string
Transaction bytes for execution
score_breakdown
object
Score breakdown object
reasoning
object
Ranking reasoning
personalization_applied
boolean
Whether personalization was applied
warnings
array
Warning messages array
expires_at
number
Expiration timestamp (Unix ms)
user_fit_score
number
User preference fit score
Score Breakdown Object
surplus_score
number
Score for surplus generation
cost_score
number
Score for cost optimization
speed_score
number
Score for execution speed
reputation_score
number
Score for solver reputation
Reasoning Object
primary_reason
string
Main reason for ranking
secondary_reasons
array
Additional ranking factors
risk_assessment
string
Risk level assessment
confidence_level
number
Confidence in ranking (0-1)
Risk Assessment Values
low
Low risk solution
medium
Medium risk solution
high
High risk solution
RankingResult
intent_id
string
Intent identifier
ranked_solutions
array
Array of ranked solutions
best_solution
RankedSolution
Top-ranked solution
metadata
object
Ranking metadata
ranked_at
number
Ranking timestamp
expires_at
number
Result expiration timestamp
Metadata Object
total_solutions
number
Total number of solutions ranked
average_score
number
Average score across all solutions
strategy
string
Ranking strategy used
intent_category
string
Intent category classification
Learn More
IGS Intents - Intent schema specification
IGS Solutions - Solution schema specification
IGS Dataset - Training data format
References
Last updated