feat: enable Platform address state transitions

Remove the 'disabled' flags gating Platform address operations and update their inputs to the SDK's WIF-based key model, dropping the manual senderNonce fields.

Expose the additional SDK exports (CoreScript, PlatformAddress, PoolingWasm, ensureInitialized) needed by the address handler, add asset-lock proof auth wiring for addressFundFromAssetLock, and cover the address operations with unit and e2e tests.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: thephez

public/AI_REFERENCE.md

@@ -2976,8 +2976,6 @@ const result = await sdk.voting.masternodeVote({ masternodeProTxHash, votePoll,
 **Address Transfer** - `addresses.transfer`
 *Transfer credits between Platform addresses*
 
-**Disabled:** Platform addresses not fully implemented in SDK
-
 Signature: `transfer(options: wasm.AddressFundsTransferOptions): Promise<Map<string, wasm.PlatformAddressInfo>>`
 
 Parameters:
@@ -3012,19 +3010,19 @@ Returns:
 
 Example:
 ```javascript
-import { PlatformAddressInput, PlatformAddressOutput, PlatformAddressSigner } from '@dashevo/evo-sdk';
-const inputs = [new PlatformAddressInput({ address: senderAddress, amount })];
-const outputs = [new PlatformAddressOutput({ address: recipientAddress, amount })];
+import { PlatformAddressSigner, PrivateKey } from '@dashevo/evo-sdk';
 const signer = new PlatformAddressSigner();
-signer.addKey(privateKey);
-await sdk.addresses.transfer({ inputs, outputs, signer });
+const senderAddress = signer.addKey(PrivateKey.fromWIF(addressPrivateKeyWif));
+const addressInfo = await sdk.addresses.get(senderAddress);
+if (!addressInfo) throw new Error('Platform Address is not funded');
+const input = { address: senderAddress.toBech32m(network), amount: BigInt(amount) };
+const output = { address: recipientAddress, amount: BigInt(amount) };
+await sdk.addresses.transfer({ inputs: [input], outputs: [output], signer });
 ```
 
 **Top Up Identity from Address** - `addresses.topUpIdentity`
 *Top up an identity using Platform address credits*
 
-**Disabled:** Platform addresses not fully implemented in SDK
-
 Signature: `topUpIdentity(options: wasm.IdentityTopUpFromAddressesOptions): Promise<wasm.IdentityTopUpFromAddressesResult>`
 
 Parameters:
@@ -3054,19 +3052,20 @@ Returns:
 
 Example:
 ```javascript
-import { PlatformAddressInput, PlatformAddressSigner } from '@dashevo/evo-sdk';
 const identity = await sdk.identities.fetch(identityId);
-const inputs = [new PlatformAddressInput({ address: senderAddress, amount })];
+if (!identity) throw new Error('Identity not found');
+import { PlatformAddressSigner, PrivateKey } from '@dashevo/evo-sdk';
 const signer = new PlatformAddressSigner();
-signer.addKey(privateKey);
-await sdk.addresses.topUpIdentity({ identity, inputs, signer });
+const senderAddress = signer.addKey(PrivateKey.fromWIF(addressPrivateKeyWif));
+const addressInfo = await sdk.addresses.get(senderAddress);
+if (!addressInfo) throw new Error('Platform Address is not funded');
+const input = { address: senderAddress.toBech32m(network), amount: BigInt(amount) };
+await sdk.addresses.topUpIdentity({ identity, inputs: [input], signer });
 ```
 
 **Withdraw to Core** - `addresses.withdraw`
 *Withdraw Platform address credits to Dash Core*
 
-**Disabled:** Platform addresses not fully implemented in SDK
-
 Signature: `withdraw(options: wasm.AddressFundsWithdrawOptions): Promise<Map<string, wasm.PlatformAddressInfo>>`
 
 Parameters:
@@ -3114,19 +3113,19 @@ Returns:
 
 Example:
 ```javascript
-import { CoreScript, PlatformAddressInput, PlatformAddressSigner } from '@dashevo/evo-sdk';
-const inputs = [new PlatformAddressInput({ address: senderAddress, amount })];
-const outputScript = CoreScript.newP2PKH(coreAddress);
+import { PlatformAddressSigner, PrivateKey } from '@dashevo/evo-sdk';
 const signer = new PlatformAddressSigner();
-signer.addKey(privateKey);
-await sdk.addresses.withdraw({ inputs, coreFeePerByte, pooling, outputScript, signer });
+const senderAddress = signer.addKey(PrivateKey.fromWIF(addressPrivateKeyWif));
+const addressInfo = await sdk.addresses.get(senderAddress);
+if (!addressInfo) throw new Error('Platform Address is not funded');
+const input = { address: senderAddress.toBech32m(network), amount: BigInt(amount) };
+const outputScript = CoreScript.fromP2PKH(coreAddressHash);
+await sdk.addresses.withdraw({ inputs: [input], coreFeePerByte, pooling: PoolingWasm.Never, outputScript, signer });
 ```
 
 **Transfer from Identity to Address** - `addresses.transferFromIdentity`
 *Transfer credits from an identity to Platform addresses*
 
-**Disabled:** Platform addresses not fully implemented in SDK
-
 Signature: `transferFromIdentity(options: wasm.IdentityTransferToAddressesOptions): Promise<wasm.IdentityTransferToAddressesResult>`
 
 Parameters:
@@ -3159,9 +3158,10 @@ Returns:
 
 Example:
 ```javascript
-import { IdentitySigner, PlatformAddressOutput } from '@dashevo/evo-sdk';
+import { IdentitySigner } from '@dashevo/evo-sdk';
 const identity = await sdk.identities.fetch(identityId);
-const outputs = [new PlatformAddressOutput({ address: recipientAddress, amount })];
+if (!identity) throw new Error('Identity not found');
+const outputs = [{ address: recipientAddress, amount: BigInt(amount) }];
 const signer = new IdentitySigner();
 signer.addKeyFromWif(privateKeyWif);
 await sdk.addresses.transferFromIdentity({ identity, outputs, signer });
@@ -3170,8 +3170,6 @@ await sdk.addresses.transferFromIdentity({ identity, outputs, signer });
 **Fund Address from Asset Lock** - `addresses.fundFromAssetLock`
 *Fund Platform addresses from an asset lock*
 
-**Disabled:** Platform addresses not fully implemented in SDK
-
 Signature: `fundFromAssetLock(options: wasm.AddressFundingFromAssetLockOptions): Promise<Map<string, wasm.PlatformAddressInfo>>`
 
 Parameters:
@@ -3210,19 +3208,18 @@ Returns:
 
 Example:
 ```javascript
-import { AssetLockProof, PlatformAddressOutput, PlatformAddressSigner, PrivateKey } from '@dashevo/evo-sdk';
+import { AssetLockProof, PlatformAddressSigner, PrivateKey } from '@dashevo/evo-sdk';
 const assetLockProof = AssetLockProof.fromHex(assetLockProofHex);
 const assetLockPrivateKey = PrivateKey.fromWIF(assetLockPrivateKeyWif);
-const outputs = [new PlatformAddressOutput({ address: recipientAddress, amount })];
 const signer = new PlatformAddressSigner();
+signer.addKey(PrivateKey.fromWIF(addressPrivateKeyWif));
+const outputs = [{ address: recipientAddress, amount: BigInt(amount) }];
 await sdk.addresses.fundFromAssetLock({ assetLockProof, assetLockPrivateKey, outputs, signer });
 ```
 
 **Create Identity from Address** - `addresses.createIdentity`
 *Create a new identity funded from Platform addresses*
 
-**Disabled:** Platform addresses not fully implemented in SDK
-
 Signature: `createIdentity(options: wasm.IdentityCreateFromAddressesOptions): Promise<wasm.IdentityCreateFromAddressesResult>`
 
 Parameters:
@@ -3261,16 +3258,16 @@ Returns:
 
 Example:
 ```javascript
-import { Identifier, Identity, IdentityPublicKeyInCreation, IdentitySigner, KeyType, PlatformAddressInput, PlatformAddressSigner, PrivateKey, Purpose, SecurityLevel } from '@dashevo/evo-sdk';
+import { Identifier, Identity, IdentityPublicKeyInCreation, IdentitySigner, KeyType, PlatformAddressSigner, PrivateKey, Purpose, SecurityLevel } from '@dashevo/evo-sdk';
 const identityPrivateKey = PrivateKey.fromWIF(identityPrivateKeyWif);
-const identity = new Identity(Identifier.random());
+const identity = new Identity(Identifier.fromBytes(crypto.getRandomValues(new Uint8Array(32))));
 const identityPublicKey = new IdentityPublicKeyInCreation({ keyId: 0, purpose: Purpose.AUTHENTICATION, securityLevel: SecurityLevel.MASTER, keyType: KeyType.ECDSA_SECP256K1, data: identityPrivateKey.getPublicKey().toBytes() }).toIdentityPublicKey();
 identity.addPublicKey(identityPublicKey);
-const inputs = [new PlatformAddressInput({ address: senderAddress, amount })];
+const addressSigner = new PlatformAddressSigner();
+const derivedAddress = addressSigner.addKey(PrivateKey.fromWIF(addressPrivateKeyWif));
+const inputs = [{ address: derivedAddress.toBech32m(network), amount: BigInt(amount) }];
 const identitySigner = new IdentitySigner();
 identitySigner.addKey(identityPrivateKey);
-const addressSigner = new PlatformAddressSigner();
-addressSigner.addKey(addressPrivateKey);
 await sdk.addresses.createIdentity({ identity, inputs, identitySigner, addressSigner });
 ```
 

public/api-definitions.json

@@ -2385,7 +2385,6 @@
         "addressTransfer": {
           "label": "Address Transfer",
           "description": "Transfer credits between Platform addresses",
-          "disabled": "Platform addresses not fully implemented in SDK",
           "inputs": [
             {
               "name": "senderAddress",
@@ -2394,13 +2393,6 @@
               "required": true,
               "placeholder": "tdash1krt0z5hrcaphyuraxmk2h2ff8nyv5fmncsgf7evf"
             },
-            {
-              "name": "senderNonce",
-              "type": "number",
-              "label": "Sender Nonce",
-              "required": true,
-              "placeholder": "0"
-            },
             {
               "name": "amount",
               "type": "text",
@@ -2420,7 +2412,6 @@
         "addressTopUpIdentity": {
           "label": "Top Up Identity from Address",
           "description": "Top up an identity using Platform address credits",
-          "disabled": "Platform addresses not fully implemented in SDK",
           "inputs": [
             {
               "name": "identityId",
@@ -2436,13 +2427,6 @@
               "required": true,
               "placeholder": "tdash1krt0z5hrcaphyuraxmk2h2ff8nyv5fmncsgf7evf"
             },
-            {
-              "name": "senderNonce",
-              "type": "number",
-              "label": "Sender Nonce",
-              "required": true,
-              "placeholder": "0"
-            },
             {
               "name": "amount",
               "type": "text",
@@ -2455,7 +2439,6 @@
         "addressWithdraw": {
           "label": "Withdraw to Core",
           "description": "Withdraw Platform address credits to Dash Core",
-          "disabled": "Platform addresses not fully implemented in SDK",
           "inputs": [
             {
               "name": "senderAddress",
@@ -2464,13 +2447,6 @@
               "required": true,
               "placeholder": "tdash1krt0z5hrcaphyuraxmk2h2ff8nyv5fmncsgf7evf"
             },
-            {
-              "name": "senderNonce",
-              "type": "number",
-              "label": "Sender Nonce",
-              "required": true,
-              "placeholder": "0"
-            },
             {
               "name": "amount",
               "type": "text",
@@ -2497,7 +2473,6 @@
         "addressTransferFromIdentity": {
           "label": "Transfer from Identity to Address",
           "description": "Transfer credits from an identity to Platform addresses",
-          "disabled": "Platform addresses not fully implemented in SDK",
           "inputs": [
             {
               "name": "recipientAddress",
@@ -2518,8 +2493,13 @@
         "addressFundFromAssetLock": {
           "label": "Fund Address from Asset Lock",
           "description": "Fund Platform addresses from an asset lock",
-          "disabled": "Platform addresses not fully implemented in SDK",
           "inputs": [
+            {
+              "name": "addressPrivateKeyWif",
+              "type": "text",
+              "label": "Recipient Platform Address Private Key (WIF)",
+              "required": true
+            },
             {
               "name": "recipientAddress",
               "type": "text",
@@ -2539,7 +2519,6 @@
         "addressCreateIdentity": {
           "label": "Create Identity from Address",
           "description": "Create a new identity funded from Platform addresses",
-          "disabled": "Platform addresses not fully implemented in SDK",
           "inputs": [
             {
               "name": "senderAddress",
@@ -2548,25 +2527,18 @@
               "required": true,
               "placeholder": "tdash1krt0z5hrcaphyuraxmk2h2ff8nyv5fmncsgf7evf"
             },
-            {
-              "name": "senderNonce",
-              "type": "number",
-              "label": "Sender Nonce",
-              "required": true,
-              "placeholder": "0"
-            },
             {
               "name": "amount",
               "type": "text",
               "label": "Amount (credits)",
               "required": true
             },
             {
-              "name": "publicKeys",
-              "type": "json",
-              "label": "Public Keys (JSON)",
+              "name": "identityPrivateKeyWif",
+              "type": "text",
+              "label": "New Identity Private Key (WIF)",
               "required": true,
-              "placeholder": "[{\"id\":0,\"type\":0,\"purpose\":0,\"securityLevel\":0,\"data\":\"...\"}]"
+              "placeholder": "c..."
             }
           ],
           "sdk_method": "addresses.createIdentity"

public/sdk-operation-catalog.json

@@ -4645,7 +4645,7 @@
       "sdkMethod": "addresses.transfer",
       "label": "Address Transfer",
       "description": "Transfer credits between Platform addresses",
-      "disabled": "Platform addresses not fully implemented in SDK",
+      "disabled": null,
       "signature": "transfer(options: wasm.AddressFundsTransferOptions): Promise<Map<string, wasm.PlatformAddressInfo>>",
       "parameters": [
         {
@@ -4718,7 +4718,7 @@
       "sdkMethod": "addresses.topUpIdentity",
       "label": "Top Up Identity from Address",
       "description": "Top up an identity using Platform address credits",
-      "disabled": "Platform addresses not fully implemented in SDK",
+      "disabled": null,
       "signature": "topUpIdentity(options: wasm.IdentityTopUpFromAddressesOptions): Promise<wasm.IdentityTopUpFromAddressesResult>",
       "parameters": [
         {
@@ -4782,7 +4782,7 @@
       "sdkMethod": "addresses.withdraw",
       "label": "Withdraw to Core",
       "description": "Withdraw Platform address credits to Dash Core",
-      "disabled": "Platform addresses not fully implemented in SDK",
+      "disabled": null,
       "signature": "withdraw(options: wasm.AddressFundsWithdrawOptions): Promise<Map<string, wasm.PlatformAddressInfo>>",
       "parameters": [
         {
@@ -4880,7 +4880,7 @@
       "sdkMethod": "addresses.transferFromIdentity",
       "label": "Transfer from Identity to Address",
       "description": "Transfer credits from an identity to Platform addresses",
-      "disabled": "Platform addresses not fully implemented in SDK",
+      "disabled": null,
       "signature": "transferFromIdentity(options: wasm.IdentityTransferToAddressesOptions): Promise<wasm.IdentityTransferToAddressesResult>",
       "parameters": [
         {
@@ -4951,7 +4951,7 @@
       "sdkMethod": "addresses.fundFromAssetLock",
       "label": "Fund Address from Asset Lock",
       "description": "Fund Platform addresses from an asset lock",
-      "disabled": "Platform addresses not fully implemented in SDK",
+      "disabled": null,
       "signature": "fundFromAssetLock(options: wasm.AddressFundingFromAssetLockOptions): Promise<Map<string, wasm.PlatformAddressInfo>>",
       "parameters": [
         {
@@ -5033,7 +5033,7 @@
       "sdkMethod": "addresses.createIdentity",
       "label": "Create Identity from Address",
       "description": "Create a new identity funded from Platform addresses",
-      "disabled": "Platform addresses not fully implemented in SDK",
+      "disabled": null,
       "signature": "createIdentity(options: wasm.IdentityCreateFromAddressesOptions): Promise<wasm.IdentityCreateFromAddressesResult>",
       "parameters": [
         {

public/src/definitions-data.js

@@ -264,27 +264,28 @@ export const TRANSITION_AUTH_REQUIREMENTS = {
   // Platform Address transitions
   addressTransfer: {
     identity: { required: false },
-    privateKey: { required: true, targets: ['privateKeyWif'] },
+    privateKey: { required: true, targets: ['addressPrivateKeyWif'] },
   },
   addressTopUpIdentity: {
     identity: { required: false },
-    privateKey: { required: true, targets: ['privateKeyWif'] },
+    privateKey: { required: true, targets: ['addressPrivateKeyWif'] },
   },
   addressWithdraw: {
     identity: { required: false },
-    privateKey: { required: true, targets: ['privateKeyWif'] },
+    privateKey: { required: true, targets: ['addressPrivateKeyWif'] },
   },
   addressTransferFromIdentity: {
     identity: { required: true, targets: ['identityId'] },
     privateKey: { required: true, targets: ['privateKeyWif'] },
   },
   addressFundFromAssetLock: {
     identity: { required: false },
+    assetLockProof: { required: true, target: 'assetLockProof' },
     privateKey: { required: true, targets: ['assetLockPrivateKeyWif'] },
   },
   addressCreateIdentity: {
     identity: { required: false },
-    privateKey: { required: true, targets: ['privateKeyWif'] },
+    privateKey: { required: true, targets: ['addressPrivateKeyWif'] },
   },
 };
 

public/src/sdk-types.js

@@ -1,14 +1,18 @@
 export {
   AssetLockProof,
+  CoreScript,
   DataContract,
   Document,
+  ensureInitialized,
   EvoSDK,
   Identifier,
   Identity,
   IdentityPublicKeyInCreation,
   IdentitySigner,
   KeyType,
+  PlatformAddress,
   PlatformAddressSigner,
+  PoolingWasm,
   PrivateKey,
   Purpose,
   SecurityLevel,