mirror of
https://github.com/chainstacklabs/pumpfun-bonkfun-bot.git
synced 2026-07-27 15:27:44 +00:00
9b4841890c
Refreshes the read-only learning examples (Phase A3) against the post
Feb–Apr 2026 IDL changes:
- CreateEvent now has 15 fields (timestamp, 4×u64 reserves, token_program,
is_mayhem_mode, is_cashback_enabled). Listener parsers were truncating
after `creator`; the v2 ones were also reading is_mayhem_mode at the
wrong offset.
- BondingCurve account is now 83 bytes (added is_cashback_coin).
- PumpSwap Pool account is now 245 bytes (added is_cashback_coin) — the
listen_programsubscribe dataSize filter was matching nothing.
- IDL instruction `createV2` was renamed to `create_v2`; the legacy
`create` instruction added a `creator: pubkey` arg in March 2026.
- decode_from_blockSubscribe.py decoder now handles bool, i64, u32, u16,
u8, and the OptionBool defined type (1-byte wire format).
Files touched (all under learning-examples/):
bonding-curve-progress/get_bonding_curve_status.py — V4 struct (cashback)
bonding-curve-progress/poll_bonding_curve_progress.py
decode_from_blockSubscribe.py
decode_from_getAccountInfo.py
decode_from_getTransaction.py
listen-migrations/compare_migration_listeners.py
listen-migrations/listen_programsubscribe.py
listen-new-tokens/compare_listeners.py
listen-new-tokens/listen_blocksubscribe.py
listen-new-tokens/listen_geyser.py
listen-new-tokens/listen_logsubscribe.py
listen-new-tokens/listen_logsubscribe_abc.py
Verified live against mainnet — listeners decode tokens including
mayhem-mode and cashback-enabled curves correctly.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
153 lines
4.7 KiB
Python
153 lines
4.7 KiB
Python
import json
|
|
import struct
|
|
import sys
|
|
|
|
import base58
|
|
|
|
tx_file_path = ""
|
|
|
|
if len(sys.argv) != 2:
|
|
tx_file_path = "learning-examples/raw_buy_tx_from_getTransaction.json"
|
|
print(f"No path provided, using the path: {tx_file_path}")
|
|
else:
|
|
tx_file_path = sys.argv[1]
|
|
|
|
# Load the IDL
|
|
with open("idl/pump_fun_idl.json") as f:
|
|
idl = json.load(f)
|
|
|
|
# Load the transaction log
|
|
with open(tx_file_path) as f:
|
|
tx_log = json.load(f)
|
|
|
|
# Extract the transaction data
|
|
tx_data = tx_log["result"]["transaction"]
|
|
|
|
print(json.dumps(tx_data, indent=2))
|
|
|
|
|
|
def decode_create_instruction(data):
|
|
"""Decode legacy Create instruction (Metaplex tokens).
|
|
|
|
IDL args (March 7, 2026 program upgrade): name, symbol, uri, creator (pubkey).
|
|
"""
|
|
offset = 8 # Skip the 8-byte discriminator
|
|
results = []
|
|
for _ in range(3):
|
|
length = struct.unpack_from("<I", data, offset)[0]
|
|
offset += 4
|
|
string_data = data[offset : offset + length].decode("utf-8")
|
|
results.append(string_data)
|
|
offset += length
|
|
|
|
creator = base58.b58encode(data[offset : offset + 32]).decode("utf-8") if offset + 32 <= len(data) else None
|
|
|
|
return {
|
|
"name": results[0],
|
|
"symbol": results[1],
|
|
"uri": results[2],
|
|
"creator": creator,
|
|
"token_standard": "legacy",
|
|
"is_mayhem_mode": False,
|
|
}
|
|
|
|
|
|
def decode_create_v2_instruction(data):
|
|
"""Decode CreateV2 instruction (Token2022 tokens).
|
|
|
|
IDL args: name, symbol, uri, creator (pubkey), is_mayhem_mode (bool),
|
|
is_cashback_enabled (OptionBool = 1 byte).
|
|
"""
|
|
offset = 8 # Skip the 8-byte discriminator
|
|
results = []
|
|
for _ in range(3):
|
|
length = struct.unpack_from("<I", data, offset)[0]
|
|
offset += 4
|
|
string_data = data[offset : offset + length].decode("utf-8")
|
|
results.append(string_data)
|
|
offset += length
|
|
|
|
creator = base58.b58encode(data[offset : offset + 32]).decode("utf-8") if offset + 32 <= len(data) else None
|
|
offset += 32
|
|
|
|
is_mayhem_mode = bool(data[offset]) if offset < len(data) else False
|
|
offset += 1
|
|
|
|
is_cashback_enabled = bool(data[offset]) if offset < len(data) else False
|
|
|
|
return {
|
|
"name": results[0],
|
|
"symbol": results[1],
|
|
"uri": results[2],
|
|
"creator": creator,
|
|
"token_standard": "token2022",
|
|
"is_mayhem_mode": is_mayhem_mode,
|
|
"is_cashback_enabled": is_cashback_enabled,
|
|
}
|
|
|
|
|
|
def decode_buy_instruction(data):
|
|
# Assuming the buy instruction has a u64 argument for amount
|
|
amount = struct.unpack_from("<Q", data, 8)[0]
|
|
return {"amount": amount}
|
|
|
|
|
|
def decode_instruction_data(instruction, accounts, data):
|
|
if instruction["name"] == "create":
|
|
return decode_create_instruction(data)
|
|
elif instruction["name"] == "create_v2":
|
|
return decode_create_v2_instruction(data)
|
|
elif instruction["name"] == "buy":
|
|
return decode_buy_instruction(data)
|
|
else:
|
|
return f"Unhandled instruction type: {instruction['name']}"
|
|
|
|
|
|
def find_matching_instruction(accounts, data):
|
|
if "instructions" not in idl:
|
|
print("Warning: No instructions found in IDL")
|
|
return None
|
|
for instruction in idl["instructions"]:
|
|
if len(instruction["accounts"]) == len(accounts):
|
|
return instruction
|
|
return None
|
|
|
|
|
|
# Parse the transaction
|
|
tx_message = tx_data["message"]
|
|
instructions = tx_message["instructions"]
|
|
|
|
for ix in instructions:
|
|
program_id = ix.get("programId")
|
|
accounts = ix.get("accounts", [])
|
|
data = ix.get("data", "")
|
|
|
|
if "parsed" in ix:
|
|
print(f"Parsed instruction: {ix['program']} - {ix['parsed']['type']}")
|
|
print(f"Info: {json.dumps(ix['parsed']['info'], indent=2)}")
|
|
elif (
|
|
program_id == "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P"
|
|
): # Pump Fun Program
|
|
matching_instruction = find_matching_instruction(accounts, data)
|
|
if matching_instruction:
|
|
decoded_data = decode_instruction_data(
|
|
matching_instruction, accounts, base58.b58decode(data)
|
|
)
|
|
print(f"Instruction: {matching_instruction['name']}")
|
|
print(f"Decoded data: {decoded_data}")
|
|
|
|
print("\nAccounts:")
|
|
for i, account in enumerate(accounts):
|
|
account_info = matching_instruction["accounts"][i]
|
|
print(f" {account_info['name']}: {account}")
|
|
else:
|
|
print(f"Unable to match instruction for program {program_id}")
|
|
else:
|
|
print(f"Instruction for program: {program_id}")
|
|
print(f"Data: {data}\n")
|
|
|
|
print("\nTransaction Information:")
|
|
print(f"Blockhash: {tx_message['recentBlockhash']}")
|
|
print(f"Fee payer: {tx_message['accountKeys'][0]['pubkey']}")
|
|
print(f"Signature: {tx_data['signatures'][0]}")
|