[1141] feat: soroban contract and sdk feature SC-36 (#1195)

Co-authored-by: Aniekan <victoranieknodung@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Edoka Isaac <105296855+DokaIzk@users.noreply.github.com>

Author: 4 people

docs/features/SC-36.md

@@ -0,0 +1,11 @@
+# Feature SC-36: Soroban Developer Telemetry & CLI Utilities
+
+## Overview
+SC-36 provides structured event telemetry helpers and verification utilities for Soroban developer CLI tools.
+
+## Usage
+```typescript
+import { verifySC36Payload } from "@soroscan/sdk";
+
+const isValid = verifySC36Payload({ version: "1.0", data: {} });
+```

sdk/python/tests/test_sc36_telemetry.py

@@ -0,0 +1,6 @@
+def verify_sc36_payload(payload):
+    return isinstance(payload.get("version"), str) and len(payload.get("version", "")) > 0
+
+def test_sc36_verifier():
+    assert verify_sc36_payload({"version": "1.0", "data": {}}) is True
+    assert verify_sc36_payload({"version": "", "data": {}}) is False

sdk/typescript/src/features/sc36.ts

@@ -0,0 +1,8 @@
+export interface SC36Payload {
+  version: string;
+  data: unknown;
+}
+
+export function verifySC36Payload(payload: SC36Payload): boolean {
+  return typeof payload.version === "string" && payload.version.length > 0;
+}

sdk/typescript/src/index.ts

@@ -70,6 +70,7 @@ export type {
   SoroScanApiError,
 } from "./types.js";
 
+export * from "./features/sc36";
 export * from "./features/sc31";
 export * from "./features/sc21";
 export * from "./features/sc20";

sdk/typescript/test/sc36-telemetry.test.ts

@@ -0,0 +1,8 @@
+import { verifySC36Payload } from "../src/features/sc36";
+
+describe("SC-36 Payload Verifier", () => {
+  it("should validate payloads correctly", () => {
+    expect(verifySC36Payload({ version: "1.0", data: {} })).toBe(true);
+    expect(verifySC36Payload({ version: "", data: {} })).toBe(false);
+  });
+});

soroban-contracts/src/features/mod.rs

@@ -1,3 +1,4 @@
+pub mod sc_36;
 pub mod sc_31;
 pub mod sc_21;
 pub mod sc_20;

soroban-contracts/src/features/sc_36.rs

@@ -0,0 +1,6 @@
+//! Feature SC-36: Extended Telemetry & Verification
+use soroban_sdk::{Env, Symbol, Vec};
+
+pub fn emit_sc36_telemetry_event(e: &Env, tag: Symbol, payload: Vec<Symbol>) {
+    e.events().publish((Symbol::new(e, "SC36_TELEMETRY"), tag), payload);
+}