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

Definition	Description
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

Property	Type	Required	Description
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

Property	Type	Required	Description
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

Value	Description
swap	Token swap operation
limit_order	Limit order execution
complex_defi	Complex DeFi strategy
arbitrage	Arbitrage opportunity
other	Other intent type

Detected Priority Values

Value	Description
speed	Speed-focused priority
cost	Cost-focused priority
output	Output-focused priority
balanced	Balanced priority

Complexity Level Values

Value	Description
simple	Simple operation
moderate	Moderate complexity
complex	High complexity

Risk Level Values

Value	Description
low	Low risk assessment
medium	Medium risk assessment
high	High risk assessment

Weights Object

Property	Type	Required	Description
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

Property	Type	Required	Description
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

Property	Type	Required	Description
solution_id	string		Solution identifier
failure_reason	string		Reason for failure
errors	array		Error details array

Feature Vector Item

Property	Type	Required	Description
solution_id	string		Solution identifier
features	object		Feature data object

Features Object

Property	Type	Required	Description
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

Property	Type	Required	Description
solution_id	string		Solution identifier
result	object		Raw simulation result from Sui

Stats Object

Property	Type	Required	Description
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

Property	Type	Required	Description
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

Property	Type	Required	Description
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

Property	Type	Required	Description
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

Value	Description
low	Low risk solution
medium	Medium risk solution
high	High risk solution

RankingResult

Property	Type	Required	Description
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

Property	Type	Required	Description
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

11KB

core-schema.json

Open