Zero Persistent Knowledge (ZPK) Protocol

ZPK-Enforcer: DNA anchor verified. ZPK-compliant. Accepted.
Validated in ledger 22189069 on Thursday, April 16, 2026 1:53 PM

function toHex(str) {
    return Array.from(str)
        .map(c => c.charCodeAt(0).toString(16).padStart(2,'0').toUpperCase())
        .join('');
}

const anchor = '09BC5A5D157C2E503831A3F2'; // 24-char DNA anchor

const memo = {
    Memo: {
        MemoType: toHex('DNA'),           // 444E41
        MemoData: toHex('DNA' + anchor)   // hex("DNA09BC5A5D157C2E503831A3F2")
    }
};

const hookParameter = {
    HookParameter: {
        HookParameterName:  '444E41',      // hex for "DNA" -- constant
        HookParameterValue: toHex(anchor)  // 24-char anchor hex-encoded = 48 hex chars
    }
};

{
    "manifest":              "<ISO 20022 XML string>",
    "originAddress":         "rSenderWalletAddress...",
    "receiverAddress":       "rReceiverWalletAddress...",
    "allowSenderReassembly": true
}

{
    "success": true,
    "dna":     "09BC5A5D157C2E503831A3F2",
    "arweaveId": "arweave-tx-id-if-uploaded"
}

{
    "address":   "rAuthorizedWalletAddress...",
    "xamanUuid": "xaman-payload-uuid",
    "authType":  "xaman",
    "timestamp": 1713300000000
}

{
    "success":   true,
    "data":      "<reassembled ISO 20022 XML>",
    "integrity": 1.0,
    "arweaveId": "arweave-tx-id"
}

const API = 'https://api.aifs.dev/api/v1';

// Step 1: Shatter the ISO message
const shatterRes = await fetch(`${API}/liquify`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        manifest:              isoXmlString,
        originAddress:         senderWalletAddress,
        receiverAddress:       receiverWalletAddress,
        allowSenderReassembly: true
    })
});
const { dna } = await shatterRes.json();

// Step 2: Build the Xahau transaction
function toHex(str) {
    return Array.from(str)
        .map(c => c.charCodeAt(0).toString(16).padStart(2,'0').toUpperCase())
        .join('');
}

const txjson = {
    TransactionType: 'Payment',
    Destination:     'rHs7o2n6r6YaRkzhg7zZFa1VWwiEx84hKr',
    Amount:          '1000', // XAH drops
    NetworkID:       21337,
    Memos: [{
        Memo: {
            MemoType: toHex('DNA'),
            MemoData: toHex('DNA' + dna)
        }
    }],
    HookParameters: [{
        HookParameter: {
            HookParameterName:  '444E41',
            HookParameterValue: toHex(dna)
        }
    }]
};

// Step 3: Submit via AIFS settle endpoint
const settleRes = await fetch(`${API}/auth/xaman/settle-xahau`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ txjson, dna })
});
const { uuid, qrUrl } = await settleRes.json();
// Display qrUrl to user for Xaman signing

// After user signs a Xaman SignIn challenge
// xamanUuid and account come from the challenge poll response

const res = await fetch(`${API}/materialize/${dnaAnchor}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        address:   account,      // wallet address from Xaman signing
        xamanUuid: xamanUuid,    // UUID of the signed challenge payload
        authType:  'xaman',
        timestamp: Date.now()
    })
});

const result = await res.json();
if (result.success) {
    // result.data contains the reassembled ISO 20022 XML
    // It exists in RAM only. Purged when session closes.
    console.log(result.data);
}

// Client-side format check only.
// Engine signature verification requires the AIFS API.

function isValidAnchorFormat(anchor) {
    return typeof anchor === 'string' && /^[0-9A-F]{24}$/.test(anchor);
}

// HookParameterValue encoding
function anchorToHookValue(anchor) {
    return Array.from(anchor)
        .map(c => c.charCodeAt(0).toString(16).padStart(2,'0').toUpperCase())
        .join('');
    // 24-char anchor becomes 48-char HookParameterValue
}

curl -X POST https://api.aifs.dev/api/v1/liquify \
  -H "Content-Type: application/json" \
  -d '{
    "manifest": "<?xml version=\"1.0\"?><Document>...</Document>",
    "originAddress": "rYourSenderWalletAddress",
    "receiverAddress": "rYourReceiverWalletAddress",
    "allowSenderReassembly": true
  }'