fix(sdk): fix documentation examples

packages/wasm-sdk/AI_REFERENCE.md

@@ -228,7 +228,7 @@ const result = await sdk.getDataContract("id");
 
 Parameters:
 - `id` (text, required) - Data Contract ID
-  - Example: `GWRSAVFMjXx8HpQFaNJMqBV7MBgMK4br5UESsB4S31Ec`
+  - Example: `HLY575cNazmc5824FxqaEMEBuzFeE4a98GDRNKbyJqCM`
 - `limit` (number, optional) - Limit
 - `offset` (number, optional) - Offset
 

packages/wasm-sdk/docs.html

@@ -1035,15 +1035,23 @@ <h5>Parameters:</h5>
                 <h5>Example</h5>
                 <div class="example-code" id="code-getIdentityKeys">return await window.wasmFunctions.get_identity_keys(sdk, '5DbLwAxGBzUzo81VewMUwn4b5P4bpv9FNFybi25XB5Bk', 'all');</div>
                 <button class="run-button" id="run-getIdentityKeys" onclick="runExample('getIdentityKeys')">Run</button>
-                <div class="example-container">
-                    <h5>Example 2 - Get Specific Keys</h5>
-                    <div class="example-code" id="code-getIdentityKeys2">return await window.wasmFunctions.get_identity_keys(sdk, '5DbLwAxGBzUzo81VewMUwn4b5P4bpv9FNFybi25XB5Bk', 'specific', [0, 1, 2]);</div>
-<button class="run-button" id="run-getIdentityKeys2" onclick="runExample('getIdentityKeys2')">Run</button>
-                    <div class="example-result" id="result-getIdentityKeys2"></div>
-                </div>
-                <div class="example-result" id="result-getIdentityKeys"></div>            </div>
-        </div>
-        <div class="operation">
+                <div class="example-result" id="result-getIdentityKeys"></div>
+            </div>
+
+            <div class="example-container">
+                <h5>Example 2 - Get Specific Keys</h5>
+                <div class="example-code" id="code-getIdentityKeys2">return await window.wasmFunctions.get_identity_keys(sdk, '5DbLwAxGBzUzo81VewMUwn4b5P4bpv9FNFybi25XB5Bk', 'specific', [0, 1, 2]);</div>
+                <button class="run-button" id="run-getIdentityKeys2" onclick="runExample('getIdentityKeys2')">Run</button>
+                <div class="example-result" id="result-getIdentityKeys2"></div>
+            </div>
+
+            <div class="example-container">
+                <h5>Example 3 - Search Keys by Purpose</h5>
+                <div class="example-code" id="code-getIdentityKeys3">return await window.wasmFunctions.get_identity_keys(sdk, '5DbLwAxGBzUzo81VewMUwn4b5P4bpv9FNFybi25XB5Bk', 'search', undefined, '{"0": {"0": "current"}, "1": {"0": "current"}}');</div>
+                <button class="run-button" id="run-getIdentityKeys3" onclick="runExample('getIdentityKeys3')">Run</button>
+                <div class="example-result" id="result-getIdentityKeys3"></div>
+            </div>
+        </div>        <div class="operation">
             <h4 id="query-getIdentitiesContractKeys">Get Identities Contract Keys</h4>
             <p class="description">Get keys for multiple identities related to a specific contract</p>
 
@@ -1349,7 +1357,7 @@ <h5>Parameters:</h5>
                     <span class="param-name">Data Contract ID</span>
                     <span class="param-type">text</span>
                     <span class="param-required">(required)</span>
-                    <br><small>Example: GWRSAVFMjXx8HpQFaNJMqBV7MBgMK4br5UESsB4S31Ec</small>
+                    <br><small>Example: HLY575cNazmc5824FxqaEMEBuzFeE4a98GDRNKbyJqCM</small>
                 </div>
                 <div class="parameter">
                     <span class="param-name">Limit</span>
@@ -1366,8 +1374,8 @@ <h5>Parameters:</h5>
 
             <div class="example-container">
                 <h5>Example</h5>
-                <div class="example-code" id="code-getDataContractHistory">return await window.wasmFunctions.get_data_contract_history(sdk, 'GWRSAVFMjXx8HpQFaNJMqBV7MBgMK4br5UESsB4S31Ec', 10, 0);</div>
-                <button class="run-button" id="run-getDataContractHistory" onclick="runExample('getDataContractHistory')">Run</button> <span style="color: #f39c12; margin-left: 10px;">🚧 Work in Progress</span>
+                <div class="example-code" id="code-getDataContractHistory">return await window.wasmFunctions.get_data_contract_history(sdk, 'HLY575cNazmc5824FxqaEMEBuzFeE4a98GDRNKbyJqCM', 10, 0);</div>
+                <button class="run-button" id="run-getDataContractHistory" onclick="runExample('getDataContractHistory')">Run</button>
                 <div class="example-result" id="result-getDataContractHistory"></div>            </div>
         </div>
         <div class="operation">
@@ -2023,8 +2031,8 @@ <h5>Parameters:</h5>
 
             <div class="example-container">
                 <h5>Example</h5>
-                <div class="example-code" id="code-getTokenPerpetualDistributionLastClaim">return await window.wasmFunctions.get_token_perpetual_distribution_last_claim(sdk, '5DbLwAxGBzUzo81VewMUwn4b5P4bpv9FNFybi25XB5Bk', 'EETVvWgohFDKtbB3ejEzBcDRMNYkc9TtgXY6y8hzP3Ta');</div>
-                <button class="run-button" id="run-getTokenPerpetualDistributionLastClaim" onclick="runExample('getTokenPerpetualDistributionLastClaim')">Run</button> <span style="color: #f39c12; margin-left: 10px;">🚧 Work in Progress</span>
+                <div class="example-code" id="code-getTokenPerpetualDistributionLastClaim">return await window.wasmFunctions.get_token_perpetual_distribution_last_claim(sdk, '5RG84o6KsTaZudDqS8ytbaRB8QP4YYQ2uwzb6Hj8cfjX', 'HEv1AYWQfwCffXQgmuzmzyzUo9untRTmVr67n4e4PSWa');</div>
+                <button class="run-button" id="run-getTokenPerpetualDistributionLastClaim" onclick="runExample('getTokenPerpetualDistributionLastClaim')">Run</button>
                 <div class="example-result" id="result-getTokenPerpetualDistributionLastClaim"></div>            </div>
         </div>
         <div class="operation">

packages/wasm-sdk/fixed_definitions.json

@@ -285,7 +285,7 @@
               "type": "text",
               "label": "Data Contract ID",
               "required": true,
-              "placeholder": "GWRSAVFMjXx8HpQFaNJMqBV7MBgMK4br5UESsB4S31Ec"
+              "placeholder": "HLY575cNazmc5824FxqaEMEBuzFeE4a98GDRNKbyJqCM"
             },
             {
               "name": "limit",

packages/wasm-sdk/generate_docs.py

@@ -130,6 +130,7 @@ def generate_example_code(query_key, inputs):
         'specialized_balance_id': 'AzaU7zqCT7X1kxh8yWxkT9PxAgNqWDu4Gz13emwcRyAT',
         'contract_id': 'GWRSAVFMjXx8HpQFaNJMqBV7MBgMK4br5UESsB4S31Ec',
         'data_contract_id': 'GWRSAVFMjXx8HpQFaNJMqBV7MBgMK4br5UESsB4S31Ec',
+        'data_contract_history_id': 'HLY575cNazmc5824FxqaEMEBuzFeE4a98GDRNKbyJqCM',
         'token_contract_id': 'ALybvzfcCwMs7sinDwmtumw17NneuW7RgFtFHgjKmF3A',
         'group_contract_id': '49PJEnNx7ReCitzkLdkDNr4s6RScGsnNexcdSZJ1ph5N',
         'public_key_hash_unique': 'b7e904ce25ed97594e72f7af0e66f298031c1754',
@@ -144,16 +145,16 @@ def generate_example_code(query_key, inputs):
 
     # Map input names to test values
     param_mapping = {
-        'id': f"'{test_data['data_contract_id']}'" if 'getDataContract' in query_key else f"'{test_data['identity_id']}'",
-        'identityId': f"'{test_data['specialized_balance_id']}'" if 'getPrefundedSpecializedBalance' in query_key else f"'{test_data['identity_id']}'",
+        'id': f"'{test_data['data_contract_history_id']}'" if 'getDataContractHistory' in query_key else f"'{test_data['data_contract_id']}'" if 'getDataContract' in query_key else f"'{test_data['identity_id']}'",
+        'identityId': f"'{test_data['specialized_balance_id']}'" if 'getPrefundedSpecializedBalance' in query_key else "'5RG84o6KsTaZudDqS8ytbaRB8QP4YYQ2uwzb6Hj8cfjX'" if 'getTokenPerpetualDistributionLastClaim' in query_key else f"'{test_data['identity_id']}'",
         'ids': f"['{test_data['data_contract_id']}', '{test_data['token_contract_id']}']" if 'getDataContracts' in query_key else f"['{test_data['pro_tx_hash']}']" if 'Evonodes' in query_key else f"['{test_data['identity_id']}']",
         'identitiesIds': f"['{test_data['identity_id']}']",
         'identityIds': f"['{test_data['identity_id']}']",
         'contractId': f"'{test_data['group_contract_id']}'" if ('group' in query_key.lower() or 'Group' in query_key) else f"'{test_data['token_contract_id']}'" if ('token' in query_key.lower() or 'Token' in query_key) and 'TokenBalance' not in query_key and 'TokenInfo' not in query_key else f"'{test_data['contract_id']}'",
         'dataContractId': "'EETVvWgohFDKtbB3ejEzBcDRMNYkc9TtgXY6y8hzP3Ta'" if 'getTokenContractInfo' in query_key else f"'{test_data['data_contract_id']}'",
         'publicKeyHash': f"'{test_data['public_key_hash_unique']}'" if 'ByPublicKeyHash' in query_key and 'NonUnique' not in query_key else f"'{test_data['public_key_hash_non_unique']}'",
         'startProTxHash': f"'{test_data['pro_tx_hash']}'",
-        'tokenId': "'EETVvWgohFDKtbB3ejEzBcDRMNYkc9TtgXY6y8hzP3Ta'" if 'getTokenPerpetualDistributionLastClaim' in query_key else f"'{test_data['token_id']}'",
+        'tokenId': "'HEv1AYWQfwCffXQgmuzmzyzUo9untRTmVr67n4e4PSWa'" if 'getTokenPerpetualDistributionLastClaim' in query_key else f"'{test_data['token_id']}'",
         'tokenIds': f"['{test_data['token_id']}', 'H7FRpZJqZK933r9CzZMsCuf1BM34NT5P2wSJyjDkprqy']" if 'getTokenStatuses' in query_key else "['H7FRpZJqZK933r9CzZMsCuf1BM34NT5P2wSJyjDkprqy']" if 'getTokenDirectPurchasePrices' in query_key else f"['{test_data['token_id']}']",
         'documentType': f"'{test_data['document_type']}'",
         'documentId': f"'{test_data['document_id']}'",
@@ -206,6 +207,10 @@ def generate_example_code(query_key, inputs):
     elif query_key == 'getGroupActions':
         # getGroupActions expects: sdk, contractId, groupContractPosition, status, startAtInfo (object or null), count
         params = [f"'{test_data['group_contract_id']}'", "0", "'ACTIVE'", "null", "100"]
+    elif query_key == 'getDataContractHistory':
+        # getDataContractHistory expects: sdk, id, limit, offset, startAtMs
+        # Use the specific contract ID for getDataContractHistory examples
+        params = ["'HLY575cNazmc5824FxqaEMEBuzFeE4a98GDRNKbyJqCM'", "10", "0"]
     else:
         # Generate parameters normally
         params = []
@@ -399,17 +404,30 @@ def generate_operation_entry(operation_key, operation, type_prefix):
             html_content += '                <p class="info-note">This is an internal query used to wait for and retrieve the result of a previously submitted state transition. It requires a valid state transition hash from a prior operation.</p>'
         else:
             html_content += f'                <button class="run-button" id="run-{operation_key}" onclick="runExample(\'{operation_key}\')">Run</button>'
-            if operation_key in ['getPathElements', 'getDataContractHistory', 'getContestedResourceVotersForIdentity', 'getTokenPerpetualDistributionLastClaim']:
+            if operation_key in ['getPathElements', 'getContestedResourceVotersForIdentity']:
                 html_content += ' <span style="color: #f39c12; margin-left: 10px;">🚧 Work in Progress</span>'
 
         # Add special examples and info
         if operation_key == 'getIdentityKeys':
-            html_content += '''\n                <div class="example-container">
-                    <h5>Example 2 - Get Specific Keys</h5>
-                    <div class="example-code" id="code-getIdentityKeys2">return await window.wasmFunctions.get_identity_keys(sdk, \'5DbLwAxGBzUzo81VewMUwn4b5P4bpv9FNFybi25XB5Bk\', \'specific\', [0, 1, 2]);</div>
-<button class="run-button" id="run-getIdentityKeys2" onclick="runExample(\'getIdentityKeys2\')">Run</button>
-                    <div class="example-result" id="result-getIdentityKeys2"></div>
-                </div>'''
+            html_content += f'''
+                <div class="example-result" id="result-{operation_key}"></div>
+            </div>
+
+            <div class="example-container">
+                <h5>Example 2 - Get Specific Keys</h5>
+                <div class="example-code" id="code-getIdentityKeys2">return await window.wasmFunctions.get_identity_keys(sdk, \'5DbLwAxGBzUzo81VewMUwn4b5P4bpv9FNFybi25XB5Bk\', \'specific\', [0, 1, 2]);</div>
+                <button class="run-button" id="run-getIdentityKeys2" onclick="runExample(\'getIdentityKeys2\')">Run</button>
+                <div class="example-result" id="result-getIdentityKeys2"></div>
+            </div>
+
+            <div class="example-container">
+                <h5>Example 3 - Search Keys by Purpose</h5>
+                <div class="example-code" id="code-getIdentityKeys3">return await window.wasmFunctions.get_identity_keys(sdk, \'5DbLwAxGBzUzo81VewMUwn4b5P4bpv9FNFybi25XB5Bk\', \'search\', undefined, \'{{"0": {{"0": "current"}}, "1": {{"0": "current"}}}}\');</div>
+                <button class="run-button" id="run-getIdentityKeys3" onclick="runExample(\'getIdentityKeys3\')">Run</button>
+                <div class="example-result" id="result-getIdentityKeys3"></div>
+            </div>
+        </div>'''
+            return html_content
         elif operation_key == 'getPathElements':
             html_content += generate_path_elements_info()
 

packages/wasm-sdk/src/context_provider.rs

@@ -45,9 +45,21 @@ impl ContextProvider for WasmContext {
 
     fn get_token_configuration(
         &self,
-        _token_id: &Identifier,
+        token_id: &Identifier,
     ) -> Result<Option<TokenConfiguration>, ContextProviderError> {
-        // Return None for now - this means the token config will be fetched from the network
+        // For WASM context without trusted provider, we need to fetch token configuration
+        // from the network. This is a simplified implementation that would need to be
+        // enhanced with actual network fetching logic in a production environment.
+
+        // TODO: Implement actual token configuration fetching from network
+        // For now, we'll return None which will cause the proof verification to fail
+        // with a clearer error message indicating missing token configuration
+
+        tracing::warn!(
+            token_id = %token_id,
+            "Token configuration not available in WASM context - this will cause proof verification to fail. Use trusted context builders for proof verification."
+        );
+
         Ok(None)
     }
 

packages/wasm-sdk/src/queries/data_contract.rs

@@ -59,7 +59,7 @@ pub async fn data_contract_fetch_with_proof_info(
 #[derive(Serialize, Deserialize, Debug)]
 #[serde(rename_all = "camelCase")]
 struct DataContractHistoryResponse {
-    versions: BTreeMap<u64, serde_json::Value>,
+    versions: BTreeMap<String, serde_json::Value>,
 }
 
 #[wasm_bindgen]
@@ -94,7 +94,7 @@ pub async fn get_data_contract_history(
 
     if let Some(history) = history_result {
         for (revision, contract) in history {
-            versions.insert(revision, contract.to_json(platform_version)?); 
+            versions.insert(revision.to_string(), contract.to_json(platform_version)?); 
         }
     }
 
@@ -183,7 +183,7 @@ pub async fn get_data_contract_history_with_proof_info(
 
     if let Some(history) = history_result {
         for (revision, contract) in history {
-            versions.insert(revision, contract.to_json(platform_version)?); 
+            versions.insert(revision.to_string(), contract.to_json(platform_version)?); 
         }
     }
 

packages/wasm-sdk/src/queries/identity.rs

@@ -157,9 +157,9 @@ pub async fn get_identity_keys(
             let request = GetIdentityKeysRequest {
                 version: Some(Version::V0(GetIdentityKeysRequestV0 {
                     identity_id: id.to_vec(),
-                    prove: true,
-                    limit: limit.map(|l| l.into()),
-                    offset: offset.map(|o| o.into()),
+                    prove: false,
+                    limit: Some(limit.unwrap_or(100).into()), // Always provide a limit when prove=false
+                    offset: None, // Offsets not supported when prove=false
                     request_type: Some(KeyRequestType {
                         request: Some(Request::SpecificKeys(SpecificKeys {
                             key_ids,
@@ -254,9 +254,9 @@ pub async fn get_identity_keys(
             let request = GetIdentityKeysRequest {
                 version: Some(Version::V0(GetIdentityKeysRequestV0 {
                     identity_id: id.to_vec(),
-                    prove: true,
-                    limit: limit.map(|l| l.into()),
-                    offset: offset.map(|o| o.into()),
+                    prove: false,
+                    limit: Some(limit.unwrap_or(100).into()), // Always provide a limit when prove=false
+                    offset: None, // Offsets not supported when prove=false
                     request_type: Some(KeyRequestType {
                         request: Some(Request::SearchKey(SearchKey {
                             purpose_map,