Interface L2PSEncryptedPayload

Payload structure for encrypted transactions within L2PS. Contains the encrypted transaction data and metadata required for decryption and verification.

interface L2PSEncryptedPayload {
    encrypted_data: string;
    l2ps_uid: string;
    nonce?: string;
    original_hash: string;
    tag: string;
}

Properties

encrypted_data: string

Base64-encoded encrypted transaction data

l2ps_uid: string

UID of the L2PS network that encrypted this transaction

nonce?: string

Base64-encoded AES-GCM nonce (12 bytes) used for this specific encryption. Required for AES-GCM safety: nonce reuse under the same key catastrophically breaks confidentiality + authentication. Optional in the type for backward compatibility — payloads written by older SDKs predating the per-call-nonce fix do not include it and decryptTx falls back to the instance IV for those.

original_hash: string

Hash of the original transaction for integrity verification

tag: string

Base64-encoded AES-GCM authentication tag