Skip to content

x402agent/SolanaOS / skills/qedgen

qedgen

Flagged

Formally verify programs by writing Lean 4 proofs. Trigger this skill whenever the user wants to formally verify code, generate Lean 4 proofs, prove properties about algorithms or smart contracts, verify invariants, convert program logic into formal specifications, or anything involving Lean 4 and formal verification. Also trigger when the user mentions "qedgen", "lean proof", "formal proof", "verify my code", "prove correctness", "formal verification", or wants mathematical guarantees about their implementation.

FileKindSize
Cargo.lockmanifest38.2 KB
Cargo.tomlmanifest347 B
LICENSEother1.0 KB
README.mdmarkdown4.1 KB
SKILL.mdskill md21.0 KB
claude.mdmarkdown9.7 KB
crates/qedgen/Cargo.tomlmanifest544 B
crates/qedgen/src/api.rsscript38.9 KB
crates/qedgen/src/asm2lean.rsscript26.2 KB
crates/qedgen/src/consolidate.rsscript6.2 KB
crates/qedgen/src/main.rsscript4.7 KB
crates/qedgen/src/project.rsscript3.0 KB
crates/qedgen/src/spec.rsscript19.4 KB
crates/qedgen/src/validate.rsscript5.6 KB
crates/qedgen/templates/Main.leanother154 B
crates/qedgen/templates/PROMPT_TEMPLATE.mdmarkdown3.2 KB
crates/qedgen/templates/README.lean.mdmarkdown1.6 KB
crates/qedgen/templates/lakefile.leanother292 B
crates/qedgen/templates/lean-toolchainother25 B
docs/CNAMEother10 B
docs/index.htmlother11.6 KB
docs/llms-full.txtmarkdown8.7 KB
docs/llms.txtmarkdown2.1 KB
docs/logo-dark.svgother648 B
docs/logo-light.svgother648 B
docs/qgn_demo.htmlother69.3 KB
docs/style.cssother8.1 KB
examples/rust/escrow/Anchor.tomlconfig353 B
examples/rust/escrow/Cargo.lockmanifest72.8 KB
examples/rust/escrow/Cargo.tomlmanifest215 B
examples/rust/escrow/migrations/deploy.tsscript428 B
examples/rust/escrow/package.jsonmanifest528 B
examples/rust/escrow/programs/escrow/Cargo.tomlmanifest376 B
examples/rust/escrow/programs/escrow/Xargo.tomlconfig62 B
examples/rust/escrow/programs/escrow/src/lib.rsscript6.7 KB
examples/rust/escrow/tests/escrow.tsscript8.6 KB
examples/rust/escrow/tsconfig.jsonconfig205 B
examples/rust/percolator/Cargo.lockmanifest8.5 KB
examples/rust/percolator/Cargo.tomlmanifest639 B
examples/rust/percolator/LICENSEother11.1 KB
examples/rust/percolator/README.mdmarkdown4.9 KB
examples/rust/percolator/examples/offsets.rsscript1.3 KB
examples/rust/percolator/scripts/audit-proof-strength.mdmarkdown6.4 KB
examples/rust/percolator/scripts/proof-strength-audit-results.mdmarkdown89.2 KB
examples/rust/percolator/scripts/run_kani_full_audit.shexecutablescript1.2 KB
examples/rust/percolator/spec.mdmarkdown108.4 KB
examples/rust/percolator/src/i128.rsscript20.4 KB
examples/rust/percolator/src/percolator.rsscript139.3 KB
examples/rust/percolator/src/wide_math.rsscript59.8 KB
examples/rust/percolator/tests/amm_tests.rsscript7.4 KB
examples/rust/percolator/tests/common/mod.rsscript4.7 KB
examples/rust/percolator/tests/fuzzing.proptest-regressionsother4.7 KB
examples/rust/percolator/tests/fuzzing.rsscript43.1 KB
examples/rust/percolator/tests/proofs_arithmetic.rsscript17.1 KB
examples/rust/percolator/tests/proofs_audit.rsscript35.0 KB
examples/rust/percolator/tests/proofs_instructions.rsscript64.8 KB
examples/rust/percolator/tests/proofs_invariants.rsscript21.0 KB
examples/rust/percolator/tests/proofs_lazy_ak.rsscript22.4 KB
examples/rust/percolator/tests/proofs_liveness.rsscript17.1 KB
examples/rust/percolator/tests/proofs_safety.rsscript104.2 KB
examples/rust/percolator/tests/proofs_v1131.rsscript25.4 KB
examples/rust/percolator/tests/unit_tests.rsscript93.8 KB
examples/sbpf/counter/src/counter.sother22.9 KB
examples/sbpf/slippage/src/asm-slippage/asm-slippage.sother698 B
examples/sbpf/transfer/src/transfer.sother2.4 KB
examples/sbpf/tree/src/tree.sother61.1 KB
install.shexecutablescript5.5 KB
lean_solana/QEDGen.leanother165 B
lean_solana/QEDGen/Solana.leanother165 B
lean_solana/QEDGen/Solana/Account.leanother4.0 KB
lean_solana/QEDGen/Solana/Authority.leanother285 B
lean_solana/QEDGen/Solana/Cpi.leanother9.0 KB
lean_solana/QEDGen/Solana/SBPF.leanother130 B
lean_solana/QEDGen/Solana/SBPF/Execute.leanother12.2 KB
lean_solana/QEDGen/Solana/SBPF/ISA.leanother5.1 KB
lean_solana/QEDGen/Solana/SBPF/Memory.leanother6.1 KB
lean_solana/QEDGen/Solana/SBPF/Tactic.leanother2.3 KB
lean_solana/QEDGen/Solana/State.leanother1.9 KB
lean_solana/QEDGen/Solana/Valid.leanother2.0 KB
lean_solana/README.mdmarkdown2.5 KB
lean_solana/lake-manifest.jsonconfig119 B
lean_solana/lakefile.leanother112 B
lean_solana/lean-toolchainother25 B
lean_solana/test_lemmas.leanother2.3 KB
package.jsonmanifest762 B
tools/qedgenexecutablescript357 B

examples/sbpf/counter/src/counter.s

View on GitHub
# Source: https://github.com/DASMAC-com/solana-opcode-guide
# Error codes.
# ------------
.equ E_N_ACCOUNTS, 1 # Invalid number of accounts.
.equ E_USER_DATA_LEN, 2 # User data length is nonzero.
.equ E_PDA_DATA_LEN, 3 # Invalid PDA data length.
.equ E_SYSTEM_PROGRAM_DATA_LEN, 4 # System Program data length is nonzero.
.equ E_PDA_DUPLICATE, 5 # PDA is a duplicate account.
.equ E_SYSTEM_PROGRAM_DUPLICATE, 6 # System Program is a duplicate account.
.equ E_UNABLE_TO_DERIVE_PDA, 7 # Unable to derive PDA.
.equ E_PDA_MISMATCH, 8 # Passed PDA does not match computed PDA.
.equ E_INVALID_INSTRUCTION_DATA_LEN, 9 # Invalid instruction data length.

# Size of assorted types.
# -----------------------
.equ SIZE_OF_PUBKEY, 32 # Size of Pubkey.
.equ SIZE_OF_U8, 1 # Size of u8.
.equ SIZE_OF_U64, 8 # Size of u64.
.equ SIZE_OF_U64_2X, 16 # Size of u64 times 2.
.equ SIZE_OF_U64_3X, 24 # Size of u64 times 3.

# Memory map layout.
# ------------------
.equ NON_DUP_MARKER, 0xff # Flag that an account is not a duplicate.
.equ DATA_LEN_ZERO, 0 # Data length of zero.
.equ DATA_LEN_SYSTEM_PROGRAM, 14 # Data length of System Program.
.equ N_ACCOUNTS_INCREMENT, 2 # Number of accounts for increment operation.
.equ N_ACCOUNTS_INIT, 3 # Number of accounts for initialize operation.
.equ N_ACCOUNTS_OFF, 0 # Number of accounts in virtual memory map.
.equ USER_DATA_LEN_OFF, 88 # User data length.
.equ USER_PUBKEY_OFF, 16 # User pubkey.
# Offset from user account data to PDA owner.
.equ USER_DATA_TO_PDA_OWNER_OFF, 10288
.equ PDA_NON_DUP_MARKER_OFF, 10344 # PDA non-duplicate marker.
.equ PDA_PUBKEY_OFF, 10352 # PDA pubkey.
.equ PDA_DATA_LEN_OFF, 10424 # PDA data length.
# PDA account data length plus account overhead.
.equ PDA_DATA_WITH_ACCOUNT_OVERHEAD, 137
.equ PDA_COUNTER_OFF, 10432 # PDA counter.
.equ PDA_BUMP_SEED_OFF, 10440 # PDA bump seed.
# System Program non-duplicate marker.
.equ SYSTEM_PROGRAM_NON_DUP_MARKER_OFF, 20680
.equ SYSTEM_PROGRAM_DATA_LEN_OFF, 20760 # System program data length.
.equ PROGRAM_ID_INIT_OFF, 31040 # Program ID during initialize operation.
# Instruction data length during increment operation.
.equ INSTRUCTION_DATA_LEN_INC_OFF, 20696
.equ COUNTER_INCREMENT_OFF, 20704 # Counter increment value.
.equ PROGRAM_ID_INC_OFF, 20712 # Program ID during increment operation.

# CreateAccount instruction data.
# -------------------------------
.equ INIT_CPI_N_ACCOUNTS, 2 # Number of accounts for CPI.
.equ INIT_CPI_INSN_DATA_LEN, 52 # Length of instruction data.
.equ INIT_CPI_DISCRIMINATOR, 0 # Discriminator.
.equ INIT_CPI_N_SIGNERS_SEEDS, 1 # Number of signers seeds.
.equ INIT_CPI_ACCT_SIZE, 9 # Account size.

# Stack frame layout for increment operation.
# -------------------------------------------
.equ STK_INC_SEED_0_ADDR_OFF, 64 # Pointer to user pubkey.
.equ STK_INC_SEED_0_LEN_OFF, 56 # Length of user pubkey.
.equ STK_INC_SEED_1_ADDR_OFF, 48 # Pointer to bump seed.
.equ STK_INC_SEED_1_LEN_OFF, 40 # Length of bump seed.
.equ STK_INC_PDA_OFF, 32 # Pointer to PDA.

# Stack frame layout for initialize operation.
# --------------------------------------------
# System Program pubkey for CreateAccount CPI.
.equ STK_INIT_SYSTEM_PROGRAM_PUBKEY_OFF, 384
.equ STK_INIT_INSN_OFF, 352 # SolInstruction for CreateAccount CPI.
# Accounts address in SolInstruction.
.equ STK_INIT_INSN_ACCOUNTS_ADDR_OFF, 344
# Accounts length in SolInstruction.
.equ STK_INIT_INSN_ACCOUNTS_LEN_OFF, 336
.equ STK_INIT_INSN_DATA_ADDR_OFF, 328 # Data address in SolInstruction.
.equ STK_INIT_INSN_DATA_LEN_OFF, 320 # Data length in SolInstruction.
# Offset from System Program pubkey to account metas.
.equ STK_INIT_SYSTEM_PROGRAM_PUBKEY_TO_ACCOUNT_METAS_OFF, 72
# Offset from account metas to instruction data.
.equ STK_INIT_ACCOUNT_METAS_TO_INSN_DATA_OFF, 32
.equ STK_INIT_INSN_DATA_OFF, 280 # CreateAccount instruction data.
# Offset of lamports field inside CreateAccount instruction data.
.equ STK_INIT_INSN_DATA_LAMPORTS_OFF, 276
# Offset of space field inside CreateAccount instruction data.
.equ STK_INIT_INSN_DATA_SPACE_OFF, 268
# Offset of owner field inside CreateAccount instruction data.
.equ STK_INIT_INSN_DATA_OWNER_OFF, 260
.equ STK_INIT_ACCT_INFOS_OFF, 224 # User account infos.
# User account meta pubkey address.
.equ STK_INIT_ACCT_META_USER_PUBKEY_ADDR_OFF, 312
# User account meta is_writable.
.equ STK_INIT_ACCT_META_USER_IS_WRITABLE_OFF, 304
# User account meta is_signer.
.equ STK_INIT_ACCT_META_USER_IS_SIGNER_OFF, 303
# PDA account meta pubkey address.
.equ STK_INIT_ACCT_META_PDA_PUBKEY_ADDR_OFF, 296
# PDA account meta is_writable.
.equ STK_INIT_ACCT_META_PDA_IS_WRITABLE_OFF, 288
# PDA account meta is_signer.
.equ STK_INIT_ACCT_META_PDA_IS_SIGNER_OFF, 287
# User account info key address.
.equ STK_INIT_ACCT_INFO_USER_KEY_ADDR_OFF, 224
# PDA account info key address.
.equ STK_INIT_ACCT_INFO_PDA_KEY_ADDR_OFF, 168
# User account info Lamports pointer.
.equ STK_INIT_ACCT_INFO_USER_LAMPORTS_ADDR_OFF, 216
# PDA account info Lamports pointer.
.equ STK_INIT_ACCT_INFO_PDA_LAMPORTS_ADDR_OFF, 160
# User account info owner pubkey pointer.
.equ STK_INIT_ACCT_INFO_USER_OWNER_ADDR_OFF, 192
# PDA account info owner pubkey pointer.
.equ STK_INIT_ACCT_INFO_PDA_OWNER_ADDR_OFF, 136
# User account info data pointer.
.equ STK_INIT_ACCT_INFO_USER_DATA_ADDR_OFF, 200
# PDA account info data pointer.
.equ STK_INIT_ACCT_INFO_PDA_DATA_ADDR_OFF, 144
# User account info is_signer.
.equ STK_INIT_ACCT_INFO_USER_IS_SIGNER_OFF, 176
# User account info is_writable.
.equ STK_INIT_ACCT_INFO_USER_IS_WRITABLE_OFF, 175
# PDA account info is_signer.
.equ STK_INIT_ACCT_INFO_PDA_IS_SIGNER_OFF, 120
# PDA account info is_writable.
.equ STK_INIT_ACCT_INFO_PDA_IS_WRITABLE_OFF, 119
.equ STK_INIT_SEED_0_ADDR_OFF, 112 # Pointer to user pubkey.
.equ STK_INIT_SEED_0_LEN_OFF, 104 # Length of user pubkey.
.equ STK_INIT_SEED_1_ADDR_OFF, 96 # Pointer to bump seed.
.equ STK_INIT_SEED_1_LEN_OFF, 88 # Length of bump seed.
.equ STK_INIT_SIGNERS_SEEDS_OFF, 80 # Pointer to signer seeds array.
# Pointer to signer seeds array element 0 length field.
.equ STK_INIT_SIGNER_SEEDS_0_LEN_OFF, 72
.equ STK_INIT_PDA_OFF, 64 # PDA.
.equ STK_INIT_RENT_OFF, 32 # Rent struct return.
.equ STK_INIT_BUMP_SEED_OFF, 8 # Bump seed.

# Assorted constants.
# -------------------
.equ NO_OFFSET, 0 # Offset of zero.
.equ SUCCESS, 0 # Indicates successful operation.
.equ BOOL_TRUE, 1 # Boolean true.
# Double wide boolean true for two consecutive fields.
.equ BOOL_TRUE_2X, 0x101
.equ N_SIGNER_SEEDS, 2 # Number of signer seeds for PDA.
.equ COMPARE_EQUAL, 0 # Compare result indicating equality.

.global entrypoint

entrypoint:
    ldxdw r2, [r1 + N_ACCOUNTS_OFF] # Get n accounts from input buffer.
    jeq r2, N_ACCOUNTS_INCREMENT, increment # Fast path to cheap operation.
    jeq r2, N_ACCOUNTS_INIT, initialize # Low priority, expensive anyways.
    mov64 r0, E_N_ACCOUNTS # Else fail.
    exit

initialize:

    # Check input memory map.
    # -----------------------
    ldxdw r2, [r1 + USER_DATA_LEN_OFF] # Get user data length.
    jne r2, DATA_LEN_ZERO, e_user_data_len # Exit if user account has data.
    ldxb r2, [r1 + PDA_NON_DUP_MARKER_OFF] # Check if PDA is a duplicate.
    jne r2, NON_DUP_MARKER, e_pda_duplicate # Exit if PDA is a duplicate.
    ldxdw r2, [r1 + PDA_DATA_LEN_OFF] # Get PDA data length.
    jne r2, DATA_LEN_ZERO, e_pda_data_len # Exit if PDA account has data.
    # Exit early if System Program is a duplicate.
    ldxb r2, [r1 + SYSTEM_PROGRAM_NON_DUP_MARKER_OFF]
    jne r2, NON_DUP_MARKER, e_system_program_duplicate
    # Exit early if System Program data length is invalid.
    ldxdw r2, [r1 + SYSTEM_PROGRAM_DATA_LEN_OFF]
    jne r2, DATA_LEN_SYSTEM_PROGRAM, e_system_program_data_len

    # Initialize signer seed for user pubkey.
    # ---------------------------------------
    mov64 r2, r1 # Get input buffer pointer.
    add64 r2, USER_PUBKEY_OFF # Update pointer to point at user pubkey.
    # Store pointer in seed 0 pointer field.
    stxdw [r10 - STK_INIT_SEED_0_ADDR_OFF], r2
    # Store length in seed 0 length field (32-bit immediate).
    stdw [r10 - STK_INIT_SEED_0_LEN_OFF], SIZE_OF_PUBKEY

    # Initialize signer seed for PDA bump key.
    # ----------------------------------------
    mov64 r2, r10 # Get stack frame pointer.
    sub64 r2, STK_INIT_BUMP_SEED_OFF # Update to point at PDA bump seed.
    # Store pointer in seed 1 pointer field.
    stxdw [r10 - STK_INIT_SEED_1_ADDR_OFF], r2
    # Store length in seed 1 length field (32-bit immediate).
    stdw [r10 - STK_INIT_SEED_1_LEN_OFF], SIZE_OF_U8

    # Compute PDA.
    # ------------
    mov64 r9, r1 # Store input buffer pointer for later.
    mov64 r1, r10 # Get stack frame pointer.
    # Update to point at user pubkey signer seed.
    sub64 r1, STK_INIT_SEED_0_ADDR_OFF
    mov64 r2, 1 # Indicate single signer seed (user pubkey).
    mov64 r3, r9 # Get input buffer pointer.
    add64 r3, PROGRAM_ID_INIT_OFF # Update to point at program ID.
    mov64 r4, r10 # Get stack frame pointer.
    sub64 r4, STK_INIT_PDA_OFF # Update to point to PDA region on stack.
    mov64 r5, r10 # Get stack frame pointer.
    sub64 r5, STK_INIT_BUMP_SEED_OFF # Update to point to bump seed region.
    call sol_try_find_program_address # Find PDA.
    # Skip check to error out if unable to derive a PDA (failure to derive
    # is practically impossible to test since odds of not finding bump seed
    # are astronomically low):
    # ```
    # jne r0, SUCCESS, e_unable_to_derive_pda
    # ```
    mov64 r1, r9 # Restore input buffer pointer.

    # Compare computed PDA against passed account.
    # --------------------------------------------
    # Update input buffer pointer to point to passed PDA.
    add64 r1, PDA_PUBKEY_OFF
    # As an optimization, store this pointer on the stack in the account
    # meta and info for the PDA, rather than deriving the pointer again.
    # Note that this must point to the pubkey in the input memory map, not
    # the one on the stack, otherwise the CPI will fail.
    stxdw [r10 - STK_INIT_ACCT_META_PDA_PUBKEY_ADDR_OFF], r1
    stxdw [r10 - STK_INIT_ACCT_INFO_PDA_KEY_ADDR_OFF], r1
    mov64 r2, r10 # Get stack frame pointer.
    sub64 r2, STK_INIT_PDA_OFF # Update to point to computed PDA.
    # Compare the pubkey values in 64-bit chunks, which is less CUs than:
    # ```
    # mov64 r3, SIZE_OF_PUBKEY # Flag size of bytes to compare.
    # mov64 r4, r10 # Get stack frame pointer.
    # sub64 r4, STK_INIT_MEMCMP_RESULT_OFF # Update to point to result.
    # call sol_memcmp_
    # ldxw r2, [r4 + NO_OFFSET] # Get compare result.
    # jne r2, COMPARE_EQUAL, e_pda_mismatch # Error out if PDA mismatch.
    # ```
    ldxdw r3, [r1 + 0]
    ldxdw r4, [r2 + 0]
    jne r3, r4, e_pda_mismatch
    ldxdw r3, [r1 + SIZE_OF_U64]
    ldxdw r4, [r2 + SIZE_OF_U64]
    jne r3, r4, e_pda_mismatch
    ldxdw r3, [r1 + SIZE_OF_U64_2X]
    ldxdw r4, [r2 + SIZE_OF_U64_2X]
    jne r3, r4, e_pda_mismatch
    ldxdw r3, [r1 + SIZE_OF_U64_3X]
    ldxdw r4, [r2 + SIZE_OF_U64_3X]
    jne r3, r4, e_pda_mismatch
    # Skip input buffer restoration since next block overwrites r1:
    # ```
    # mov64 r1, r9 # Restore input buffer pointer.
    # ```

    # Calculate Lamports required for new account.
    # --------------------------------------------
    mov64 r1, r10 # Get stack frame pointer.
    sub64 r1, STK_INIT_RENT_OFF # Update to point to Rent struct.
    call sol_get_rent_sysvar # Get Rent struct.
    ldxdw r2, [r1 + NO_OFFSET] # Get Lamports per byte field.
    # Multiply by sum of PDA account data length, account storage overhead.
    mul64 r2, PDA_DATA_WITH_ACCOUNT_OVERHEAD
    # Store value directly in instruction data on stack.
    stxdw [r10 - STK_INIT_INSN_DATA_LAMPORTS_OFF], r2
    # Skip input buffer restoration since block after next overwrites r1:
    # ```
    # mov64 r1, r9 # Restore input buffer pointer.
    # ```

    # Populate SolInstruction on stack.
    # ---------------------------------
    mov64 r3, r10 # Get stack frame pointer for stepping through stack.
    # Update to point to zero-initialized System Program pubkey on stack.
    sub64 r3, STK_INIT_SYSTEM_PROGRAM_PUBKEY_OFF
    stxdw [r10 - STK_INIT_INSN_OFF], r3 # Store as CPI program ID.
    # Advance to point to account metas.
    add64 r3, STK_INIT_SYSTEM_PROGRAM_PUBKEY_TO_ACCOUNT_METAS_OFF
    # Store pointer to account metas as CPI account metas address.
    stxdw [r10 - STK_INIT_INSN_ACCOUNTS_ADDR_OFF], r3
    # Store number of CPI accounts (fits in 32-bit immediate).
    stdw [r10 - STK_INIT_INSN_ACCOUNTS_LEN_OFF], INIT_CPI_N_ACCOUNTS
    # Advance to point to instruction data.
    add64 r3, STK_INIT_ACCOUNT_METAS_TO_INSN_DATA_OFF
    stxdw [r10 - STK_INIT_INSN_DATA_ADDR_OFF], r3 # Store CPI data address.
    # Store instruction data length (fits in 32-bit immediate).
    stdw [r10 - STK_INIT_INSN_DATA_LEN_OFF], INIT_CPI_INSN_DATA_LEN

    # Populate CreateAccount instruction data on stack.
    # ---------------------------------------------------------------------
    # - Discriminator is already set to 0 since stack is zero initialized.
    # - Lamports field was already set in the minimum balance calculation.
    # ---------------------------------------------------------------------
    # Store the data length of the account to create (fits in 32 bits).
    stdw [r10 - STK_INIT_INSN_DATA_SPACE_OFF], INIT_CPI_ACCT_SIZE
    mov64 r1, r10 # Get pointer to stack frame.
    sub64 r1, STK_INIT_INSN_DATA_OWNER_OFF # Point to new owner field.
    mov64 r2, r9 # Get input buffer pointer.
    add64 r2, PROGRAM_ID_INIT_OFF # Point to program ID.
    # Copy the pubkey value in 64-bit chunks, which is less CUs than:
    # ```
    # mov64 r3, SIZE_OF_PUBKEY # Set length of bytes to copy.
    # call sol_memcpy_ # Copy program ID into CreateAccount owner field.
    # ```
    ldxdw r3, [r2 + 0]
    stxdw [r1 + 0], r3
    ldxdw r3, [r2 + SIZE_OF_U64]
    stxdw [r1 + SIZE_OF_U64], r3
    ldxdw r3, [r2 + SIZE_OF_U64_2X]
    stxdw [r1 + SIZE_OF_U64_2X], r3
    ldxdw r3, [r2 + SIZE_OF_U64_3X]
    stxdw [r1 + SIZE_OF_U64_3X], r3

    # Flag user and PDA accounts as CPI writable signers.
    # ---------------------------------------------------
    sth [r10 - STK_INIT_ACCT_META_USER_IS_WRITABLE_OFF], BOOL_TRUE_2X
    sth [r10 - STK_INIT_ACCT_META_PDA_IS_WRITABLE_OFF], BOOL_TRUE_2X
    sth [r10 - STK_INIT_ACCT_INFO_USER_IS_SIGNER_OFF], BOOL_TRUE_2X
    sth [r10 - STK_INIT_ACCT_INFO_PDA_IS_SIGNER_OFF], BOOL_TRUE_2X
    # Optimize out 4 CUs by omitting the following assignments, which are
    # covered by the double wide boolean true assign since is_signer
    # follows is_writable in SolAccountMeta, and is_writable follows
    # is_signer in SolAccountInfo.
    # ```
    # stb [r10 - STK_INIT_ACCT_META_USER_IS_SIGNER_OFF], BOOL_TRUE
    # stb [r10 - STK_INIT_ACCT_META_PDA_IS_SIGNER_OFF], BOOL_TRUE
    # stb [r10 - STK_INIT_ACCT_INFO_USER_IS_WRITABLE_OFF], BOOL_TRUE
    # stb [r10 - STK_INIT_ACCT_INFO_PDA_IS_WRITABLE_OFF], BOOL_TRUE
    # ```

    # Walk through remaining pointer fields for account metas and infos.
    # ---------------------------------------------------------------------
    # - Rent epoch is ignored since is not needed.
    # - Data length and executable status are ignored since both values are
    #   zero and the stack is zero-initialized.
    # - PDA pubkey is ignored since it was set above as an optimization
    #   during the PDA compare operation.
    # ---------------------------------------------------------------------
    mov64 r2, r9 # Get input buffer pointer.
    add64 r2, USER_PUBKEY_OFF # Update to point at user pubkey.
    # Store in account meta and account info.
    stxdw [r10 - STK_INIT_ACCT_META_USER_PUBKEY_ADDR_OFF], r2
    stxdw [r10 - STK_INIT_ACCT_INFO_USER_KEY_ADDR_OFF], r2
    add64 r2, SIZE_OF_PUBKEY # Advance to point at user owner.
    # Store in account info.
    stxdw [r10 - STK_INIT_ACCT_INFO_USER_OWNER_ADDR_OFF], r2
    add64 r2, SIZE_OF_PUBKEY # Advance to point at user Lamports.
    # Store in account info.
    stxdw [r10 - STK_INIT_ACCT_INFO_USER_LAMPORTS_ADDR_OFF], r2
    add64 r2, SIZE_OF_U64_2X # Advance to point to user account data.
    # Store in account info.
    stxdw [r10 - STK_INIT_ACCT_INFO_USER_DATA_ADDR_OFF], r2
    # Advance to point to PDA owner. Note that this must be used instead of
    # the System Program pubkey on the stack or the CPI will fail.
    add64 r2, USER_DATA_TO_PDA_OWNER_OFF
    stxdw [r10 - STK_INIT_ACCT_INFO_PDA_OWNER_ADDR_OFF], r2
    # Advance to point to PDA Lamports.
    add64 r2, SIZE_OF_PUBKEY
    # Store in account info.
    stxdw [r10 - STK_INIT_ACCT_INFO_PDA_LAMPORTS_ADDR_OFF], r2
    add64 r2, SIZE_OF_U64_2X # Advance to point to PDA account data.
    # Store in account info.
    stxdw [r10 - STK_INIT_ACCT_INFO_PDA_DATA_ADDR_OFF], r2

    # Populate SignerSeeds structure.
    # -------------------------------
    mov64 r2, r10 # Get stack frame pointer.
    sub64 r2, STK_INIT_SEED_0_ADDR_OFF # Update to point to signer seed 0.
    stxdw [r10 - STK_INIT_SIGNERS_SEEDS_OFF], r2 # Store in SignerSeeds.
    # Store number of signer seeds for PDA (32-bit immediate).
    stdw [r10 - STK_INIT_SIGNER_SEEDS_0_LEN_OFF], N_SIGNER_SEEDS

    # Invoke CreateAccount CPI.
    # -------------------------
    mov64 r1, r10 # Get stack frame pointer.
    sub64 r1, STK_INIT_INSN_OFF # Point to instruction.
    mov64 r2, r10 # Get stack frame pointer.
    sub64 r2, STK_INIT_ACCT_INFOS_OFF # Point to account infos.
    mov64 r3, INIT_CPI_N_ACCOUNTS # Indicate number of account infos.
    mov64 r4, r10 # Get stack frame pointer.
    sub64 r4, STK_INIT_SIGNERS_SEEDS_OFF # Point to single SignerSeeds.
    mov64 r5, INIT_CPI_N_SIGNERS_SEEDS # Indicate a single signer.
    call sol_invoke_signed_c

    # Write bump seed to new account.
    # -------------------------------
    ldxb r2, [r10 - STK_INIT_BUMP_SEED_OFF] # Load bump seed from stack.
    stxb [r9 + PDA_BUMP_SEED_OFF], r2 # Store in new PDA account data.

    exit

increment:

    # Get user data length with padding.
    # ----------------------------------
    ldxdw r9, [r1 + USER_DATA_LEN_OFF] # Get user data length.
    # Speculatively add max possible padding. This will not overflow
    # because max account data length fits in a u32.
    add64 r9, 7
    # Clear low 3 bits, thereby truncating to 8-byte alignment. This yields
    # the data length plus (optional) required padding.
    and64 r9, -8

    # Check remaining memory map layout.
    # ----------------------------------
    # Sum input buffer offset and padded user data length, affecting
    # subsequent offsets originally calculated assuming no user account
    # data: get input buffer pointer offset by padded user data length.
    add64 r9, r1
    ldxb r8, [r9 + PDA_NON_DUP_MARKER_OFF] # Load PDA duplicate marker.
    jne r8, NON_DUP_MARKER, e_pda_duplicate # Exit if PDA is a duplicate.
    ldxdw r8, [r9 + PDA_DATA_LEN_OFF] # Get PDA data length.
    jne r8, INIT_CPI_ACCT_SIZE, e_pda_data_len # Exit if invalid length.
    # Get instruction data length.
    ldxdw r8, [r9 + INSTRUCTION_DATA_LEN_INC_OFF]
    # Exit if invalid length.
    jne r8, SIZE_OF_U64, e_invalid_instruction_data_len
    mov64 r3, r9 # Copy input buffer offset by padded user data length.
    # Update to point to program ID, for later verification syscall.
    add64 r3, PROGRAM_ID_INC_OFF
    mov64 r6, r9 # Copy input buffer offset by padded user data length.
    # Update to point to PDA pubkey, for later verification syscall.
    add64 r6, PDA_PUBKEY_OFF

    # Process counter increment instruction.
    # ---------------------------------------------------------------------
    # This is done speculatively, before PDA bump seeds are verified, to
    # minimize number of pointer copies during happy path. If this were
    # done after signer seed verification, the pointer to the input buffer
    # offset by user data length would need to be copied.
    # ---------------------------------------------------------------------
    ldxdw r8, [r9 + COUNTER_INCREMENT_OFF] # Get increment amount.
    ldxdw r7, [r9 + PDA_COUNTER_OFF] # Get current PDA counter value.
    add64 r7, r8 # Wrapping increment counter value by instruction amount.
    stxdw [r9 + PDA_COUNTER_OFF], r7 # Store value in PDA account.

    # Prepare signer seeds for PDA verification.
    # ------------------------------------------
    # Directly mutate input buffer pointer to point to user pubkey, since
    # this is the last access of the input buffer pointer for this branch
    # and a pointer copy can thus be optimized out.
    add64 r1, USER_PUBKEY_OFF
    # Store pointer in seed 0 pointer field.
    stxdw [r10 - STK_INC_SEED_0_ADDR_OFF], r1
    # Store length in seed 0 length field (32-bit immediate).
    stdw [r10 - STK_INC_SEED_0_LEN_OFF], SIZE_OF_PUBKEY
    # Directly mutate input pointer offset by padded user data length to
    # point at PDA bump seed, since this is the last access of the offset
    # pointer for this branch and a pointer copy can thus be optimized out.
    add64 r9, PDA_BUMP_SEED_OFF
    # Store pointer in seed 1 pointer field.
    stxdw [r10 - STK_INC_SEED_1_ADDR_OFF], r9
    # Store length in seed 1 length field (32-bit immediate).
    stdw [r10 - STK_INC_SEED_1_LEN_OFF], SIZE_OF_U8

    # Re-derive PDA.
    # ---------------------------------------------------------------------
    # r3 was set to program ID pointer during memory map checks.
    # ---------------------------------------------------------------------
    mov64 r1, r10 # Get stack frame pointer.
    sub64 r1, STK_INC_SEED_0_ADDR_OFF # Update to point to signer seeds.
    mov64 r2, N_SIGNER_SEEDS # Load signer seeds count (32-bit immediate).
    mov64 r4, r10 # Get stack frame pointer.
    sub64 r4, STK_INC_PDA_OFF # Update to point to PDA result on stack.
    call sol_create_program_address # Create PDA.
    jne r0, SUCCESS, e_unable_to_derive_pda # Error if unable to create.

    # Verify PDA.
    # ---------------------------------------------------------------------
    # r6 was set to passed PDA pubkey pointer during memory map checks.
    # ---------------------------------------------------------------------
    mov64 r1, r6 # Get pointer to passed PDA pubkey, set above.
    mov64 r2, r4 # Get pointer to computed PDA.
    # Compare pubkey values in 64-bit chunks (same optimization as in the
    # initialize operation):
    ldxdw r3, [r1 + 0]
    ldxdw r4, [r2 + 0]
    jne r3, r4, e_pda_mismatch
    ldxdw r3, [r1 + SIZE_OF_U64]
    ldxdw r4, [r2 + SIZE_OF_U64]
    jne r3, r4, e_pda_mismatch
    ldxdw r3, [r1 + SIZE_OF_U64_2X]
    ldxdw r4, [r2 + SIZE_OF_U64_2X]
    jne r3, r4, e_pda_mismatch
    ldxdw r3, [r1 + SIZE_OF_U64_3X]
    ldxdw r4, [r2 + SIZE_OF_U64_3X]
    jne r3, r4, e_pda_mismatch

    exit

e_user_data_len:
    mov32 r0, E_USER_DATA_LEN
    exit

e_pda_data_len:
    mov32 r0, E_PDA_DATA_LEN
    exit

e_system_program_data_len:
    mov32 r0, E_SYSTEM_PROGRAM_DATA_LEN
    exit

e_pda_duplicate:
    mov32 r0, E_PDA_DUPLICATE
    exit

e_system_program_duplicate:
    mov32 r0, E_SYSTEM_PROGRAM_DUPLICATE
    exit

e_pda_mismatch:
    mov32 r0, E_PDA_MISMATCH
    exit

e_invalid_instruction_data_len:
    mov32 r0, E_INVALID_INSTRUCTION_DATA_LEN
    exit

e_unable_to_derive_pda:
    mov32 r0, E_UNABLE_TO_DERIVE_PDA
    exit
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall