From a1b46edd2b3359e4bd250d0c17ea362a3d238362 Mon Sep 17 00:00:00 2001
From: Zk-nd3r <zk-nd3r@users.noreply.github.com>
Date: Mon, 15 Jun 2026 13:16:02 +0700
Subject: [PATCH] Add Zkool ZAP1 memo plugin

---
 plugins/zkool/README.md                      |  20 ++++++
 plugins/zkool/zap1-memo-plugin.zip           | Bin 0 -> 1098 bytes
 plugins/zkool/zap1-memo-plugin/main.rhai     |  63 +++++++++++++++++++
 plugins/zkool/zap1-memo-plugin/manifest.json |  10 +++
 4 files changed, 93 insertions(+)
 create mode 100644 plugins/zkool/README.md
 create mode 100644 plugins/zkool/zap1-memo-plugin.zip
 create mode 100644 plugins/zkool/zap1-memo-plugin/main.rhai
 create mode 100644 plugins/zkool/zap1-memo-plugin/manifest.json

diff --git a/plugins/zkool/README.md b/plugins/zkool/README.md
new file mode 100644
index 0000000..8102064
--- /dev/null
+++ b/plugins/zkool/README.md
@@ -0,0 +1,20 @@
+# Zkool ZAP1 Memo Plugin
+
+Zkool supports memo plugins through its Plugin Manager. This package renders
+ZAP1 structured memo strings such as:
+
+```text
+ZAP1:01:075b00df286038a7b3f6bb70054df61343e3481fba579591354a00214e9e019b
+```
+
+It matches the `ZAP1` prefix, labels known type bytes, keeps the raw hash
+visible, and links non-root entries to the ZAP1 proof endpoint.
+
+Install URL after this lands on `main`:
+
+```text
+https://github.com/Frontier-Compute/zap1/raw/main/plugins/zkool/zap1-memo-plugin.zip
+```
+
+Source files are under `plugins/zkool/zap1-memo-plugin/`. The zip is flat
+because Zkool expects `manifest.json` and `main.rhai` at archive root.
diff --git a/plugins/zkool/zap1-memo-plugin.zip b/plugins/zkool/zap1-memo-plugin.zip
new file mode 100644
index 0000000000000000000000000000000000000000..bf83dfce21937573f6514943ddb3fb93798b669d
GIT binary patch
literal 1098
zcmWIWW@Zs#U|`^2xRiN5W@Uw=;T9lIk&%Ic7f9zO=4Ga(7MJK{73b&q_FHowau8_w
z{io}3maPysx3%D#mMdK?Pd81{es}PlTgRh%^Xcp<r*Gz$rR{H(a^D>`f6BH4b1MUR
z9!<#kvQpec-s9@M#r;+0n;C7=e$}nhE|nHv#g??B^uJq@xU-v9@T{V%3#aP^O<V8X
zvg?eb_C=-WB2TgJCDX1>IqbA|>bwo13Qal_G^bW?jQo4Al`SaCjJNOEhLsA=PI6D%
z=gC#+8L=%~=y{R#q#VDV#H#}@ABF#63_$VTj<>Ha>|tVHIKjcdzzOzVW}aSAMq*~`
zwAlPb4k8Zs|B7z@%(60YWmDAU9FMtS!K}?&^0sGkJPNoOpve4gTjuZk<q6z-uN*Wr
z6tsAL?oL1FFY7NJ!Rl#O_~&IRoqVyi@kjf`lJjLR<W}eT2U^Fn+V@Dk?`_-f9R2G}
zMf7yf*VCtn)jU}IMriK*#rGKYirKw;AXsIu(AE&((sGOO$jS);3>QU(mN&fM?9@{T
zQM}09qNWn!@TIkdt)p?m3+5yZB@@xTd#8pwpV;jbxB9~d<!r_K>pyI;pEp6?A@1dY
zvfP$K8?+9*3!Hf2eF*CfpZy|T*7pky=f3pznR_Aja=@wjPnoR7QFl%yJ?d+6ywI8&
z7y0XsVq5OrgR-G>gI~<hZjLy8vgF~5ZNAgW_Fikf)q3*!1^pa%b3L_Xq4{4In5uQp
ztTccAd$o9ohR>O$wx;XmwEmO#ZWi-zKXa_lm1onX^shnkUN*AHm7aY|j2bL{8rp7}
ztLXCl$gX*U$BoV^w?%s%xVC=tmdd?no^C9?rj%{ERXy1|{%ZC-kIfYu*A(vE(s*fV
zrMFJA`Fx9-S3mUnug<(SWBW4SSGxO;Z94HOElqyTeCfxx9vqIDw`hi|oUhRHPCM79
z){09sBc6V?o#2?B-m^<O-F`wyq?>vvziFi0)Q#KnHa#t5n7BmehOJk#+NCOnGyTTu
zuIbV(j|DZnEz0}#nWgdygdawm-?{weZfJncugS_kd*2klzi6Nnc8ptW=|u6?h`dFo
zn&<y=I{3+X^Rdl8>-JeamCIfmIqh_~uK$L6Ge4}V4c+7=#&-T|g33P8<EwgRPE9($
zY0;zHS;tOB?tXjB@pSq{JzkB^i<Vc+zclSQ^Y;2+u^;-mbGA;6??0sw*&r;p@a%Eb
zPtp4)WwhJRPn()|^mmH3>=cVnr+F%PI_sad_xtTL*ZOZS^lGW&mfzv^CeIfi+WqU|
z%d~whbN(Ct<PPv=WD;S(ori(x90{Q0XmqXU`2(TvK9HH42+b`4-mGjODJCE+0@8<=
GK|BDFXXQEo

literal 0
HcmV?d00001

diff --git a/plugins/zkool/zap1-memo-plugin/main.rhai b/plugins/zkool/zap1-memo-plugin/main.rhai
new file mode 100644
index 0000000..c7e407d
--- /dev/null
+++ b/plugins/zkool/zap1-memo-plugin/main.rhai
@@ -0,0 +1,63 @@
+fn get_prefixes() {
+    return ["5a415031"];
+}
+
+fn hex_char(byte) {
+    if byte == 48 { return "0"; }
+    if byte == 49 { return "1"; }
+    if byte == 50 { return "2"; }
+    if byte == 51 { return "3"; }
+    if byte == 52 { return "4"; }
+    if byte == 53 { return "5"; }
+    if byte == 54 { return "6"; }
+    if byte == 55 { return "7"; }
+    if byte == 56 { return "8"; }
+    if byte == 57 { return "9"; }
+    if byte == 65 || byte == 97 { return "a"; }
+    if byte == 66 || byte == 98 { return "b"; }
+    if byte == 67 || byte == 99 { return "c"; }
+    if byte == 68 || byte == 100 { return "d"; }
+    if byte == 69 || byte == 101 { return "e"; }
+    if byte == 70 || byte == 102 { return "f"; }
+    return "?";
+}
+
+fn type_label(type_hex) {
+    if type_hex == "01" { return "PROGRAM_ENTRY"; }
+    if type_hex == "02" { return "OWNERSHIP_ATTEST"; }
+    if type_hex == "03" { return "CONTRACT_ANCHOR"; }
+    if type_hex == "04" { return "DEPLOYMENT"; }
+    if type_hex == "05" { return "HOSTING_PAYMENT"; }
+    if type_hex == "06" { return "SHIELD_RENEWAL"; }
+    if type_hex == "07" { return "TRANSFER"; }
+    if type_hex == "08" { return "EXIT"; }
+    if type_hex == "09" { return "MERKLE_ROOT"; }
+    if type_hex == "0a" { return "STAKING_DEPOSIT"; }
+    if type_hex == "0b" { return "STAKING_WITHDRAW"; }
+    if type_hex == "0c" { return "STAKING_REWARD"; }
+    if type_hex == "0d" { return "GOVERNANCE_PROPOSAL"; }
+    if type_hex == "0e" { return "GOVERNANCE_VOTE"; }
+    if type_hex == "0f" { return "GOVERNANCE_RESULT"; }
+    return "UNKNOWN";
+}
+
+fn process_memo() {
+    let type_hex = hex_char(memo::read_u8(5)) + hex_char(memo::read_u8(6));
+    let hash = memo::read_string(8, 64);
+    let label = type_label(type_hex);
+    let headers = ["Field", "Value"];
+    let rows = [
+        [cell_string("Protocol"), cell_string("ZAP1")],
+        [cell_string("Type"), cell_string(type_hex)],
+        [cell_string("Label"), cell_string(label)],
+        [cell_string("Hash"), cell_string(hash)],
+    ];
+
+    if type_hex != "09" {
+        let url = "https://api.frontiercompute.cash/verify/" + hash;
+        url += "/proof.json";
+        rows.push([cell_string("Proof"), cell_url(url)]);
+    }
+
+    return [section("ZAP1 Memo", headers, rows)];
+}
diff --git a/plugins/zkool/zap1-memo-plugin/manifest.json b/plugins/zkool/zap1-memo-plugin/manifest.json
new file mode 100644
index 0000000..1541d1c
--- /dev/null
+++ b/plugins/zkool/zap1-memo-plugin/manifest.json
@@ -0,0 +1,10 @@
+{
+    "id": "cash.frontiercompute.zap1-memo",
+    "name": "ZAP1 Memo Parser",
+    "version": "1.0.0",
+    "author": "Frontier Compute",
+    "description": "Parses ZAP1 structured attestation memos.",
+    "min_app_version": "6.20.0",
+    "types": ["memo"],
+    "entry_point": "main.rhai"
+}