pyth-network_pyth-crosschain/lazer/publisher_sdk/proto/pyth_lazer_transaction.proto

syntax = "proto3";
package pyth_lazer;

import "publisher_update.proto";
import "governance_instruction.proto";

// if any fields marked as [required] are missing, transaction will be rejected
// if signature does not match payload bytes, transaction will be rejected

// Signed transaction for lazer
// Payload should be created on the publisher side and encoded as bytes.
// Resulting bytes should then be signed with the signature scheme specified.
// The signed lazer transaction is encoded as bytes and sent to Pyth Lazer Relayer.
message SignedLazerTransaction {
    // [required] signature with public key
    optional SignatureData signature_data = 1;

    // [required] lazer transaction payload encoded as bytes.
    //
    // If the signature data is a Ed25519SignatureData, the payload is the encoded
    // LazerTransaction protobuf message.
    //
    // If the signature data is a WormholeMultiSigData, the payload is the encoded
    // Wormhole VAA body. The Wormhole VAA can be any of the following:
    // 1. A governance message from Pyth that updates Lazer state (e.g. a new feed) which
    // is an ecoded GovernancePayload according to xc-admin spec which contains the
    // encoded GovernanceInstruction protobuf message.
    // 2. A governance message from Wormhole that updates Wormhole guardian set which follows
    // the Wormhole specification.
    optional bytes payload = 2;
}

// Signature for encoded payload along with the relevant public keys to verify against it
// Public key should successfully verify payload
// Pyth Lazer will maintain a list of valid public keys
// Passed public key should be present in publisher's list of valid keys
message SignatureData {
    // [required] type of signature, which determines included data needed for verifying
    oneof data {
        Ed25519SignatureData ed25519 = 1;
        WormholeMultiSigData wormholeMultiSig = 2;
    };
}

// Wormhole multisig data which is the proto encoding of the VAA
// header taken from the following wire format:
// https://github.com/wormhole-foundation/wormhole/blob/main/whitepapers/0001_generic_message_passing.md
message WormholeMultiSigData {
    // [required] Protocol version of the entire VAA.
    optional int32 version = 1;

    // [required] GuardianSetIndex is the index of the guardian set that signed
    // this VAA. Signatures are verified against the public keys in the
    // guardian set.
    optional int32 guardianSetIndex = 2;

    // Signatures contain a list of signatures made by the guardian set.
    repeated WormholeGuardianSignature signatures = 3;
}

// Wormhole multisig signature
message WormholeGuardianSignature {
    // [required] Index of the guardian that signed the transaction
    optional int32 index = 1;

    // [required] 65 byte eccdsa signature
    optional bytes signature = 2;
}

// ED25519 style signature. Should include a single signature and a single public key
// Signature will be verified using public key after determining public key is valid
message Ed25519SignatureData {
    // [required] 64 byte signature
    optional bytes signature = 1;

    // [required] 32 byte public key
    optional bytes public_key = 2;
}

// Transaction contianing one of the valid Lazer Transactions
message LazerTransaction {
    // [required] valid transaction types supported by pyth lazer
    oneof payload {
        // Expected transaction sent by Publishers
        // May contain many individual updates to various feeds
        PublisherUpdate publisher_update = 1;
        // Sent by governance.
        GovernanceInstruction governance_instruction = 2;
    }
}