feat:implement Soroban contract and sdk feature sc-10 (#1190)

Co-authored-by: hunter-baddie <sulyman.m1703634@st.futminna.edu.ng.com>

Author: esenyidaniel-hash

sdk/python/soroscan/cli.py

@@ -130,6 +130,21 @@ def _handle_contracts(args: argparse.Namespace) -> int:
     return 0
 
 
+def _handle_record_event(args: argparse.Namespace) -> int:
+    """Submit a single event to the SoroScan contract (SC-10)."""
+    with _build_client(args) as client:
+        result = client.record_event(
+            contract_id=args.contract_id,
+            event_type=args.event_type,
+            payload_hash=args.payload_hash,
+        )
+    if args.output == "json":
+        _print_json(result)
+    else:
+        _print_table([result], ["status", "tx_hash", "transaction_status", "error"])
+    return 0
+
+
 def _handle_webhooks(args: argparse.Namespace) -> int:
     with _build_client(args) as client:
         if args.webhook_command == "test":
@@ -210,6 +225,20 @@ def build_parser() -> argparse.ArgumentParser:
     )
     contracts_event_types.set_defaults(func=_handle_contracts)
 
+    # SC-10: record a single event from the CLI
+    record = subcommands.add_parser(
+        "record-event",
+        help="Submit a single event to the SoroScan indexing contract",
+    )
+    record.add_argument("contract_id", help="Target contract address (C...)")
+    record.add_argument("event_type", help="Event type name (e.g. transfer, swap)")
+    record.add_argument(
+        "payload_hash",
+        help="SHA-256 hex hash of the event payload (64 hex chars)",
+    )
+    record.add_argument("--output", choices=["table", "json"], default="table")
+    record.set_defaults(func=_handle_record_event)
+
     return parser
 
 

sdk/python/tests/test_sc10_cli.py

@@ -0,0 +1,135 @@
+"""Tests for the SC-10 record-event CLI command."""
+
+import json
+
+import pytest
+from pytest_httpx import HTTPXMock
+
+from soroscan.cli import main, build_parser
+
+
+BASE_CONTRACT = "CCAAA111222333444555666777888999AAABBBCCCDDDEEEFFF"
+EVENT_TYPE = "transfer"
+PAYLOAD_HASH = "a" * 64
+
+RECORD_RESPONSE = {
+    "status": "submitted",
+    "tx_hash": "txabc123",
+    "transaction_status": "pending",
+    "error": None,
+}
+
+
+# ── Parser tests (no HTTP needed) ────────────────────────────────────────────
+
+class TestRecordEventParser:
+    def test_record_event_subcommand_exists(self):
+        parser = build_parser()
+        args = parser.parse_args([
+            "record-event",
+            BASE_CONTRACT,
+            EVENT_TYPE,
+            PAYLOAD_HASH,
+        ])
+        assert args.contract_id == BASE_CONTRACT
+        assert args.event_type == EVENT_TYPE
+        assert args.payload_hash == PAYLOAD_HASH
+        assert args.output == "table"
+
+    def test_record_event_json_flag(self):
+        parser = build_parser()
+        args = parser.parse_args([
+            "record-event",
+            BASE_CONTRACT,
+            EVENT_TYPE,
+            PAYLOAD_HASH,
+            "--output", "json",
+        ])
+        assert args.output == "json"
+
+    def test_record_event_missing_args_exits(self):
+        parser = build_parser()
+        with pytest.raises(SystemExit):
+            parser.parse_args(["record-event"])
+
+
+# ── Integration tests (HTTP mocked) ──────────────────────────────────────────
+
+class TestRecordEventCLI:
+    def test_record_event_table_output(
+        self,
+        base_url: str,
+        httpx_mock: HTTPXMock,
+        capsys,
+    ) -> None:
+        httpx_mock.add_response(
+            url=f"{base_url}/api/record-event/",
+            method="POST",
+            json=RECORD_RESPONSE,
+            status_code=201,
+        )
+
+        exit_code = main([
+            "--base-url", base_url,
+            "record-event",
+            BASE_CONTRACT,
+            EVENT_TYPE,
+            PAYLOAD_HASH,
+        ])
+
+        assert exit_code == 0
+        output = capsys.readouterr().out
+        assert "submitted" in output
+        assert "txabc123" in output
+
+    def test_record_event_json_output(
+        self,
+        base_url: str,
+        httpx_mock: HTTPXMock,
+        capsys,
+    ) -> None:
+        httpx_mock.add_response(
+            url=f"{base_url}/api/record-event/",
+            method="POST",
+            json=RECORD_RESPONSE,
+            status_code=201,
+        )
+
+        exit_code = main([
+            "--base-url", base_url,
+            "record-event",
+            BASE_CONTRACT,
+            EVENT_TYPE,
+            PAYLOAD_HASH,
+            "--output", "json",
+        ])
+
+        assert exit_code == 0
+        data = json.loads(capsys.readouterr().out)
+        assert data["status"] == "submitted"
+        assert data["tx_hash"] == "txabc123"
+        assert data["error"] is None
+
+    def test_record_event_api_error_prints_to_stderr(
+        self,
+        base_url: str,
+        httpx_mock: HTTPXMock,
+        capsys,
+    ) -> None:
+        httpx_mock.add_response(
+            url=f"{base_url}/api/record-event/",
+            method="POST",
+            json={"detail": "Indexer not authorized"},
+            status_code=403,
+        )
+
+        exit_code = main([
+            "--base-url", base_url,
+            "record-event",
+            BASE_CONTRACT,
+            EVENT_TYPE,
+            PAYLOAD_HASH,
+        ])
+
+        assert exit_code == 1
+        assert "Error" in capsys.readouterr().err