[WIP] cli and doc updates (#168)

* cli updates

* cli updates

Author: dixitaniket

src/opengradient/cli.py

@@ -376,7 +376,7 @@ def infer(ctx, model_cid: str, inference_mode: str, input_data, input_file: Path
     "x402_settlement_mode",
     type=click.Choice(x402SettlementModes.keys()),
     default="settle-batch",
-    help="Settlement mode for x402 payments: settle (hashes only), settle-batch (batched, default), settle-metadata (full data)",
+    help="Settlement mode for x402 payments: settle (payment only), settle-batch (batched, default), settle-metadata (full data)",
 )
 @click.pass_context
 def completion(
@@ -469,7 +469,7 @@ def print_llm_completion_result(model_cid, tx_hash, llm_output, is_vanilla=True)
     "--x402-settlement-mode",
     type=click.Choice(x402SettlementModes.keys()),
     default="settle-batch",
-    help="Settlement mode for x402 payments: settle (hashes only), settle-batch (batched, default), settle-metadata (full data)",
+    help="Settlement mode for x402 payments: settle (payment only), settle-batch (batched, default), settle-metadata (full data)",
 )
 @click.option("--stream", is_flag=True, default=False, help="Stream the output from the LLM")
 @click.pass_context

src/opengradient/types.py

@@ -19,11 +19,10 @@ class x402SettlementMode(str, Enum):
     privacy, and transaction costs.
 
     Attributes:
-        SETTLE: Individual settlement with input/output hashes only.
-            Also known as SETTLE_INDIVIDUAL in some documentation.
-            Records cryptographic hashes of the inference input and output.
-            Most privacy-preserving option - actual data is not stored on-chain.
-            Suitable for applications where only proof of execution is needed.
+        SETTLE: Most private settlement method.
+            Only the payment is settled on-chain — no input or output hashes are posted to the chain.
+            Your inference data remains completely off-chain, ensuring maximum privacy.
+            Suitable for applications where payment settlement is required without any on-chain record of execution.
             CLI usage: --settlement-mode settle
 
         SETTLE_METADATA: Individual settlement with full metadata.
@@ -48,9 +47,9 @@ class x402SettlementMode(str, Enum):
         'settle'
     """
 
-    SETTLE = "settle"
-    SETTLE_METADATA = "settle-metadata"
-    SETTLE_BATCH = "settle-batch"
+    SETTLE = "private"
+    SETTLE_METADATA = "individual"
+    SETTLE_BATCH = "batch"
 
     # Aliases for backward compatibility with glossary naming
     SETTLE_INDIVIDUAL = SETTLE

tests/client_test.py

@@ -311,9 +311,9 @@ def test_from_sse_data_with_usage(self):
 class TestX402SettlementMode:
     def test_settlement_modes_values(self):
         """Test settlement mode enum values."""
-        assert x402SettlementMode.SETTLE == "settle"
-        assert x402SettlementMode.SETTLE_BATCH == "settle-batch"
-        assert x402SettlementMode.SETTLE_METADATA == "settle-metadata"
+        assert x402SettlementMode.SETTLE == "private"
+        assert x402SettlementMode.SETTLE_BATCH == "batch"
+        assert x402SettlementMode.SETTLE_METADATA == "individual"
 
     def test_settlement_mode_aliases(self):
         """Test settlement mode aliases."""