Submission Commands

model

Register, update, and manage models on the network.

Note

State-modifying subcommands accept transaction processing arguments.

commit

Commit a new model (phase 1 of commit-reveal).

soma model commit <MODEL_ID> [OPTIONS]

Argument	Type	Required	Description
model_id	ObjectID	Yes	Model object ID
--weights-url-commitment	hex (32 bytes)	Yes	Commitment hash for the weights URL
--weights-commitment	hex (32 bytes)	Yes	Commitment hash for the weights
--architecture-version	u64	No	Architecture version (auto-fetched if omitted)
--stake-amount	SomaAmount	Yes	Amount of SOMA to stake
--commission-rate	u16	No	Commission rate in basis points (default 0)
--staking-pool-id	ObjectID	Yes	Staking pool to use

soma model commit 0xMODEL... \
  --weights-url-commitment 0xABC...DEF \
  --weights-commitment 0x123...456 \
  --stake-amount 100 \
  --staking-pool-id 0xPOOL...

reveal

Reveal model weights (phase 2 of commit-reveal).

soma model reveal <MODEL_ID> [OPTIONS]

Argument	Type	Required	Description
model_id	ObjectID	Yes	Model object ID
--weights-url	string	Yes	URL where weights are hosted
--weights-checksum	hex (32 bytes)	Yes	Checksum of the weights file
--weights-size	u64	Yes	Size of the weights file in bytes
--decryption-key	hex (32 bytes)	Yes	Key to decrypt the weights
--embedding	string	Yes	Comma-separated floats representing the model embedding

soma model reveal 0xMODEL... \
  --weights-url https://storage.example.com/model.bin \
  --weights-checksum 0xABC...DEF \
  --weights-size 1048576 \
  --decryption-key 0x789...012 \
  --embedding 0.1,0.2,0.3,0.4

update-commit

Commit updated weights for an active model.

soma model update-commit <MODEL_ID> [OPTIONS]

Argument	Type	Required	Description
model_id	ObjectID	Yes	Model object ID
--weights-url-commitment	hex (32 bytes)	Yes	New commitment hash for the weights URL
--weights-commitment	hex (32 bytes)	Yes	New commitment hash for the weights

soma model update-commit 0xMODEL... \
  --weights-url-commitment 0xNEW...ABC \
  --weights-commitment 0xNEW...DEF

update-reveal

Reveal updated weights for an active model.

soma model update-reveal <MODEL_ID> [OPTIONS]

Argument	Type	Required	Description
model_id	ObjectID	Yes	Model object ID
--weights-url	string	Yes	Updated URL where weights are hosted
--weights-checksum	hex (32 bytes)	Yes	Checksum of the updated weights
--weights-size	u64	Yes	Size of the updated weights in bytes
--decryption-key	hex (32 bytes)	Yes	Key to decrypt the updated weights
--embedding	string	Yes	Comma-separated floats for the updated embedding

soma model update-reveal 0xMODEL... \
  --weights-url https://storage.example.com/model-v2.bin \
  --weights-checksum 0xNEW...ABC \
  --weights-size 2097152 \
  --decryption-key 0xNEW...KEY \
  --embedding 0.5,0.6,0.7,0.8

deactivate

Deactivate a model. Only the model owner can deactivate.

soma model deactivate <MODEL_ID>

Argument	Type	Required	Description
model_id	ObjectID	Yes	Model object ID

soma model deactivate 0xMODEL...

info

Display model information.

soma model info <MODEL_ID>

Argument	Type	Required	Description
model_id	ObjectID	Yes	Model object ID

soma model info 0xMODEL...

list

List all registered models.

soma model list

set-commission-rate

Set the commission rate for a model.

soma model set-commission-rate <MODEL_ID> --commission-rate <RATE>

Argument	Type	Required	Description
model_id	ObjectID	Yes	Model object ID
--commission-rate	u16	Yes	Commission rate in basis points (max 10000)

soma model set-commission-rate 0xMODEL... --commission-rate 500

download

Download model weights via the proxy network.

soma model download <MODEL_ID> [OPTIONS]

Argument	Type	Required	Description
model_id	ObjectID	Yes	Model object ID
-o, --output	path	No	Output file path (default: ./<model_id>.weights)

soma model download 0xMODEL...

soma model download 0xMODEL... -o ./my-model.weights

target

List targets, submit data, and claim rewards.

Note

State-modifying subcommands accept transaction processing arguments.

list

List targets with optional filters.

soma target list [OPTIONS]

Argument	Type	Required	Description
-s, --status	string	No	Filter by status: open, filled, claimed
-e, --epoch	u64	No	Filter by epoch
--limit	u64	No	Max number of results (default 50)

soma target list

soma target list --status open --epoch 5 --limit 20

info

Show target information.

soma target info <TARGET_ID>

Argument	Type	Required	Description
target_id	ObjectID	Yes	Target object ID

soma target info 0xTARGET...

submit

Submit data to fill a target.

soma target submit [OPTIONS]

Argument	Type	Required	Description
--target-id	ObjectID	Yes	Target to fill
--data-commitment	hex (32 bytes)	Yes	Commitment hash for the submitted data
--data-url	string	Yes	URL where data is hosted
--data-checksum	hex (32 bytes)	Yes	Checksum of the data
--data-size	u64	Yes	Size of the data in bytes
--model-id	ObjectID	Yes	Model used for the submission
--embedding	string	Yes	Comma-separated floats for the data embedding
--distance-score	f32	Yes	Distance score between data and target embeddings
--bond-coin	ObjectID	Yes	Coin object to use as bond

soma target submit \
  --target-id 0xTARGET... \
  --data-commitment 0xABC...DEF \
  --data-url https://storage.example.com/submission.bin \
  --data-checksum 0x123...456 \
  --data-size 524288 \
  --model-id 0xMODEL... \
  --embedding 0.1,0.2,0.3 \
  --distance-score 0.95 \
  --bond-coin 0xCOIN...

claim

Claim rewards from a filled target. The challenge window must be closed.

soma target claim <TARGET_ID>

Argument	Type	Required	Description
target_id	ObjectID	Yes	Target object ID

soma target claim 0xTARGET...

download

Download submission data for a target.

soma target download <TARGET_ID> [OPTIONS]

Argument	Type	Required	Description
target_id	ObjectID	Yes	Target object ID
-o, --output	path	No	Output file path

soma target download 0xTARGET...

soma target download 0xTARGET... -o ./submission-data.bin

challenge

Submit fraud challenges and inspect challenge status.

Note

State-modifying subcommands accept transaction processing arguments.

submit

Submit a fraud challenge against a filled target. Requires a bond proportional to the data size.

soma challenge submit [OPTIONS]

Argument	Type	Required	Description
--target-id	ObjectID	Yes	Target to challenge
--bond-coin	ObjectID	Yes	Coin object to use as bond

soma challenge submit --target-id 0xTARGET... --bond-coin 0xCOIN...

info

Show challenge information.

soma challenge info <CHALLENGE_ID>

Argument	Type	Required	Description
challenge_id	ObjectID	Yes	Challenge object ID

soma challenge info 0xCHALLENGE...