From: Ardis Lu Date: Fri, 5 Jan 2024 04:45:36 +0000 (-0800) Subject: Initial commit X-Git-Url: https://git.ardis.lu/?a=commitdiff_plain;h=669d05023e001ff6b28c0044c1b08e22417afd79;p=event-hashes Initial commit --- 669d05023e001ff6b28c0044c1b08e22417afd79 diff --git a/.github/etherscan.webp b/.github/etherscan.webp new file mode 100644 index 0000000..f26e360 Binary files /dev/null and b/.github/etherscan.webp differ diff --git a/.github/event-hashes.webp b/.github/event-hashes.webp new file mode 100644 index 0000000..68ad260 Binary files /dev/null and b/.github/event-hashes.webp differ diff --git a/Inter.woff2 b/Inter.woff2 new file mode 100644 index 0000000..c659f5e Binary files /dev/null and b/Inter.woff2 differ diff --git a/Inter_600.woff2 b/Inter_600.woff2 new file mode 100644 index 0000000..fff3df9 Binary files /dev/null and b/Inter_600.woff2 differ diff --git a/Inter_700.woff2 b/Inter_700.woff2 new file mode 100644 index 0000000..fff3df9 Binary files /dev/null and b/Inter_700.woff2 differ diff --git a/README.md b/README.md new file mode 100644 index 0000000..2ad9318 --- /dev/null +++ b/README.md @@ -0,0 +1,32 @@ +# event-hashes + +This is a minimal web utility to calculate the `keccak256` hashes of the normalized event signatures of all the events in a Solidity code block. This hash can then be used with indexers like Etherscan to search for specific logs in the EVM history. + +> [!WARNING]
+> This tool won't work with [user-defined value types](https://docs.soliditylang.org/en/latest/types.html#user-defined-value-types). For events that include these types, you must manually convert the user-defined value type into its equivalent primitive type. + +## Example + +![Demonstration of the event-hashes web UI hashing the ERC-20 Transfer event.](./.github/event-hashes.webp) + +Given the [standard ERC-20 `Transfer` event](https://eips.ethereum.org/EIPS/eip-20#events): + +``` +event Transfer(address indexed _from, address indexed _to, uint256 _value) +``` + +The tool will normalize the event signature (i.e., remove spaces, input names, and extraneous keywords): + +``` +Transfer(address,address,uint256) +``` + +Then calculate the `keccak256` hash of the UTF-8 encoded bytes of the normalized signature: + +``` +0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef +``` + +This hash may then be used in another tool to filter a smart contract's logs, e.g. [in Etherscan](https://etherscan.io/address/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48#events): + +![The "Events" page of a token smart contract on Etherscan, filtered to only the events matching the previously calculated Keccak-256 hash.](./.github/etherscan.webp) diff --git a/index.html b/index.html new file mode 100644 index 0000000..e7c7a8c --- /dev/null +++ b/index.html @@ -0,0 +1,245 @@ + + + + + + + + + + + + + + + + + + Event Hashes + + + + +

Event Hashes

Enter Solidity code below to calculate the Keccak-256 hashes for all the events.

+ +

+ Solidity code + + + + + + + + + + +

Normalized Event Signature	Keccak-256 Hash

+ + + + + + + \ No newline at end of file diff --git a/keccak256.js b/keccak256.js new file mode 100644 index 0000000..6531e46 --- /dev/null +++ b/keccak256.js @@ -0,0 +1,6 @@ +function g(t){if(!Number.isSafeInteger(t)||t<0)throw new Error(`Wrong positive integer: ${t}`)}function R(t){return t instanceof Uint8Array||t!=null&&typeof t=="object"&&t.constructor.name==="Uint8Array"}function b(t,...e){if(!R(t))throw new Error("Expected Uint8Array");if(e.length>0&&!e.includes(t.length))throw new Error(`Expected Uint8Array of length ${e}, not of length=${t.length}`)}function k(t,e=!0){if(t.destroyed)throw new Error("Hash instance has been destroyed");if(e&&t.finished)throw new Error("Hash#digest() has already been called")}function L(t,e){b(t);let n=e.outputLen;if(t.length>_&d)}:{h:Number(t>>_&d)|0,l:Number(t&d)|0}}function A(t,e=!1){let n=new Uint32Array(t.length),r=new Uint32Array(t.length);for(let s=0;st<>>32-n,B=(t,e,n)=>e<>>32-n,O=(t,e,n)=>e<>>64-n,I=(t,e,n)=>t<>>64-n;var E=t=>new Uint32Array(t.buffer,t.byteOffset,Math.floor(t.byteLength/4));function M(t){return t instanceof Uint8Array||t!=null&&typeof t=="object"&&t.constructor.name==="Uint8Array"}var W=new Uint8Array(new Uint32Array([287454020]).buffer)[0]===68;if(!W)throw new Error("Non little-endian hardware is not supported");function D(t){if(typeof t!="string")throw new Error(`utf8ToBytes expected string, got ${typeof t}`);return new Uint8Array(new TextEncoder().encode(t))}function w(t){if(typeof t=="string"&&(t=D(t)),!M(t))throw new Error(`expected Uint8Array, got ${typeof t}`);return t}var x=class{clone(){return this._cloneInto()}},et={}.toString;function U(t){let e=r=>t().update(w(r)).digest(),n=t();return e.outputLen=n.outputLen,e.blockLen=n.blockLen,e.create=()=>t(),e}function H(t){let e=(r,s)=>t(s).update(w(r)).digest(),n=t({});return e.outputLen=n.outputLen,e.blockLen=n.blockLen,e.create=r=>t(r),e}var[F,j,X]=[[],[],[]],P=BigInt(0),h=BigInt(1),v=BigInt(2),q=BigInt(7),z=BigInt(256),G=BigInt(113);for(let t=0,e=h,n=1,r=0;t<24;t++){[n,r]=[r,(2*n+3*r)%5],F.push(2*(5*r+n)),j.push((t+1)*(t+2)/2%64);let s=P;for(let i=0;i<7;i++)e=(e<>q)*G)%z,e&v&&(s^=h<<(h<n>32?O(t,e,n):m(t,e,n),T=(t,e,n)=>n>32?I(t,e,n):B(t,e,n);function Q(t,e=24){let n=new Uint32Array(10);for(let r=24-e;r<24;r++){for(let o=0;o<10;o++)n[o]=t[o]^t[o+10]^t[o+20]^t[o+30]^t[o+40];for(let o=0;o<10;o+=2){let c=(o+8)%10,p=(o+2)%10,l=n[p],u=n[p+1],N=S(l,u,1)^n[c],C=T(l,u,1)^n[c+1];for(let a=0;a<50;a+=10)t[o+a]^=N,t[o+a+1]^=C}let s=t[2],i=t[3];for(let o=0;o<24;o++){let c=j[o],p=S(s,i,c),l=T(s,i,c),u=F[o];s=t[u],i=t[u+1],t[u]=p,t[u+1]=l}for(let o=0;o<50;o+=10){for(let c=0;c<10;c++)n[c]=t[o+c];for(let c=0;c<10;c++)t[o+c]^=~n[(c+2)%10]&n[(c+4)%10]}t[0]^=J[r],t[1]^=K[r]}n.fill(0)}var y=class t extends x{constructor(e,n,r,s=!1,i=24){if(super(),this.blockLen=e,this.suffix=n,this.outputLen=r,this.enableXOF=s,this.rounds=i,this.pos=0,this.posOut=0,this.finished=!1,this.destroyed=!1,g(r),0>=this.blockLen||this.blockLen>=200)throw new Error("Sha3 supports only keccak-f1600 function");this.state=new Uint8Array(200),this.state32=E(this.state)}keccak(){Q(this.state32,this.rounds),this.posOut=0,this.pos=0}update(e){k(this);let{blockLen:n,state:r}=this;e=w(e);let s=e.length;for(let i=0;i=r&&this.keccak();let o=Math.min(r-this.posOut,i-s);e.set(n.subarray(this.posOut,this.posOut+o),s),this.posOut+=o,s+=o}return e}xofInto(e){if(!this.enableXOF)throw new Error("XOF is not possible for this instance");return this.writeInto(e)}xof(e){return g(e),this.xofInto(new Uint8Array(e))}digestInto(e){if(L(e,this),this.finished)throw new Error("digest() was already called");return this.writeInto(e),this.destroy(),e}digest(){return this.digestInto(new Uint8Array(this.outputLen))}destroy(){this.destroyed=!0,this.state.fill(0)}_cloneInto(e){let{blockLen:n,suffix:r,outputLen:s,rounds:i,enableXOF:o}=this;return e||(e=new t(n,r,s,o,i)),e.state32.set(this.state32),e.pos=this.pos,e.posOut=this.posOut,e.finished=this.finished,e.rounds=i,e.suffix=r,e.outputLen=s,e.enableXOF=o,e.destroyed=this.destroyed,e}},f=(t,e,n)=>U(()=>new y(e,t,n)),it=f(6,144,224/8),ct=f(6,136,256/8),ft=f(6,104,384/8),ut=f(6,72,512/8),ht=f(1,144,224/8),Y=f(1,136,256/8),pt=f(1,104,384/8),lt=f(1,72,512/8),$=(t,e,n)=>H((r={})=>new y(e,t,r.dkLen===void 0?n:r.dkLen,!0)),at=$(31,168,128/8),dt=$(31,136,256/8);export{Y as keccak256}; +/*! Bundled license information: + +@noble/hashes/esm/utils.js: + (*! noble-hashes - MIT License (c) 2022 Paul Miller (paulmillr.com) *) +*/