streamich / ass-js

Assembler.js — X86_64 and Ethereum

Important

If you or your company are using any of my projects or like what I'm doing, please consider backing me up. I appreciate it! 🙏 Your support will help me allocate more time to the open source work.

• Become a sponsor
• Buy me a coffee ☕️
• or send a Solana airdrop 🚀 🌘, SOL: LJJwteDZjL8u2Uhh5giwVpRa5KcHLkDogYAZntYbMsD

I maintain and contribute to OSS software, below is a list of my latest projects and writings. My current focus is on developing CRDT and OT collaborative editing solutions, local-first software, and Web3 apps.

---

My Projects

• UI and React
  • react-use and libreact — lots of React hooks and utility components.
  • nano-css and nano-theme — the fastest and smallest CSS-in-JS library with lots of plugins (successor of freestyler).
  • react-embed — embed social widgets in your React app.
  • use-media — CSS media queries through React hook.
  • react-simple-player — a minimalistic audio player React component.
  • clickable-json — JSON viewer and editor with hoverable and clickable objects.
  • flexible-input — React <input> and <textarea> components which stretch to fit the content.
  • collaborative-input — React <input> and <textarea> components with JSON CRDT real-time collaboration support.
  • collaborative-ace — JSON CRDT real-time collaboration bindings for Ace editor.
  • collaborative-monaco — JSON CRDT real-time collaboration bindings for the Monaco editor.
  • collaborative-codemirror — JSON CRDT real-time collaboration bindings for the CodeMirror editor.
  • awesome-styleguides — index of style guides and design systems.
  • code-colors and code-colors-react — code syntax highlighting libraries.
  • use-t — a small internationalization library for React.
  • iconista — a React component for rendering open-source SVG icons.
  • react-router-lite — a lightweight React router.
• Filesystem
  • memfs — a virtual filesystem for Node.js and browser, plus OPFS file system helpers.
  • unionfs — creates a union of multiple filesystem volumes.
  • fs-monkey — monkey-patches Node's fs module and require function.
  • linkfs — redirects filesystem paths.
  • spyfs — spies on filesystem actions.
• Data structures, algorithms, and utilities
  • json-joy, a JSON CRDT implementation and collection of JSON awesomeness.
    • json-joy/json-crdt — the fastest list CRDT implementation in JavaScript.
    • json-joy/json-patch — very fast JSON Patch (and JSON Pointer) implementation in JavaScript.
    • json-joy/json-expression — JSON Expression implementation.
    • json-joy/json-type — the fastest JSON schema validation implementation in JavaScript.
  • git-cz — feat: 🎸 emoji-fied Git commits
  • sonic-forest — very fast AVL, Splay, and Radix tree implementations in JavaScript.
  • thingies — a collection of useful TypeScript utilities.
  • rx-use — useful RxJS observables for web apps.
  • tree-dump — utility to easily print tree-like structures.
  • cross-ci — env var normalization across CI/CD services.
  • web4 🔜 soon — CRDT-based content-addressable local-first data repository.
• Parsing
  • json-pack — the fastest CBOR, MessagePack, RESP3, UBJSON, JSON, and Bencode codecs in plain JavaScript.
  • jit-router — the fastest HTTP router in JavaScript.
  • md-mdast — extremely small and fast Markdown to MDAST parser.
  • mdast-flat — MDAST format to flat-MDAST converter.
  • mqtt-codec 🧪💥 experimental — the fastest MQTT packet parser for Node.js.
  • jit-parser 🧪💥 experimental — PoC of LL recursive backtracking descent JIT parser generator.
• Server & Networking
  • ass-js 🧪💥 experimental — X86_64 assembler compiler in JavaScript.
  • reactive-rcp 🧪💥 experimental — a very fast and type safe JSON Reactive RPC server and client.
  • redis-joy 🧪💥 experimental — a very fast Redis 7+ RESP3 standalone and cluster client.
  • node-multicore 🧪💥 experimental — PoC of a very fast thread pool for Node.js.

My Writings

• Specifications
  • spec JSON CRDT — Full JSON implementation as a CRDT (Conflict-free Replicated Datatype).
  • spec JSON CRDT Patch — The patch format for JSON CRDT.
  • spec JSON Expression — s-expression specification for JSON.
  • spec JSON Reactive RPC — JSON Reactive RPC protocol (RPC with server push) implementation.
  • encoding Compact JSON — A compact Tuple-Type-Value (TTV) encoding for JSON.
• Blog posts
  • blog Fuzz Testing RGA CRDT
  • blog Benchmarking JSON Serialization Codecs
  • blog List CRDT Benchmarks
  • blog Blazing Fast List CRDT
• My random notes
  • note Programming
  • note JavaScript
  • note Collaborative editing
  • note Funny GitHub profiles

---

Thank You

Your support means a lot to me and will help me to continue working on my projects!

Support

• Become a sponsor
• Buy me a coffee ☕️
• or send a Solana airdrop 🚀 🌘, SOL: LJJwteDZjL8u2Uhh5giwVpRa5KcHLkDogYAZntYbMsD

ass-js's Issues

Better docs

• Improve docs
• Create API reference

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Warning

These dependencies are deprecated:

Datasource	Name	Replacement PR?
npm	ethereumjs-vm

Edited/Blocked

These updates have been manually edited so Renovate will no longer make changes. To discard all commits and start over, click on a checkbox.

• fix(deps): update dependency fast-extend to v1

Detected dependencies

npm

package.json

• fast-extend ^0.0.2
• jest 29.7.0
• jest-tap-reporter 1.9.0
• ts-jest 29.1.5
• typescript 5.5.2
• ts-node 10.9.2
• gulp 5.0.0
• gulp-typescript 5.0.1
• mkdirp 3.0.1
• coffee-register 2.2.0
• static-buffer 1.0.1
• rimraf 5.0.7
• ethereumjs-vm 4.2.0
• semantic-release 24.0.0
• @types/node 20.14.9
• @types/jest 29.5.12
• mol-conventional-changelog 1.4.3

travis

.travis.yml

• node 9
• node 8
• node 7
• node 6

---

• Check this box to trigger a request for Renovate to run again on this repository

Unresolved license status

This is a wildly fascinating idea to me, but since there's no licensing noted anywhere I'm hesitant to do anything with it, since it's "in limbo", legally speaking.

Would you be willing to specify an open source license in the project?

I personally use the Very Open License in all my code (the Unlicense is very similar), but Choose A License will walk you through the more popular options.

Wrong encoding of 'sub' instruction

When the sub instruction is used, it is encoded as an adc (current npm version)

var assjs = require('ass-js');
var asm = assjs.X64();
asm._('sub', ['rax', 0x42]);
asm._('sub', ['rax', 0x4242]);
asm._('sub', ['rax', 'rbx']);
asm._('sub', ['rbx', 0x42]);
asm._('sub', ['rbx', 0x4242]);
asm._('sub', ['rbx', 'rbx']);
console.log(asm.toString());
console.log(asm.compile());

Code:

000 main:
001     subq    rax, 0x42                       ; 000000|000000 0x48, 0x83, 0xD0, 0x42 4 bytes
002     subq    rax, 0x00004242                 ; 000004|000004 0x48, 0x15, 0x42, 0x42, 0x00, 0x00 6 bytes
003     subq    rax, rbx                        ; 00000A|00000A 0x48, 0x11, 0xD8 3 bytes
004     subq    rbx, 0x42                       ; 00000D|00000D 0x48, 0x83, 0xD3, 0x42 4 bytes
005     subq    rbx, 0x00004242                 ; 000011|000011 0x48, 0x81, 0xD3, 0x42, 0x42, 0x00, 0x00 7 bytes
006     subq    rbx, rbx                        ; 000018|000018 0x48, 0x11, 0xDB 3 bytes

Encoding:
<Buffer 48 83 d0 42 48 15 42 42 00 00 48 11 d8 48 83 d3 42 48 81 d3 42 42 00 00 48 11 db>

Expected encoding:
<Buffer 48 83 e8 42 48 2d 42 42 00 00 48 29 d8 48 83 eb 42 48 81 eb 42 42 00 00 48 29 db>

question about readme

I just came across it and only briefly skimmed the readme.
In the sample code, it declares asm, but the very next line says code.compile. I’m not sure if it means asm.compile or something else.
Anyway, I’m just genuinely curious. Thanks for the hard work!

Question

Hey there,

I was looking at your project and I couldn't figure out a reason as to why I would (and what, rather) implement with this.

Would you have any example that would clarify why someone would use ass-js ? [this sounds terrible]

Thank you!

The automated release is failing 🚨

🚨 The automated release from the master branch failed. 🚨

I recommend you give this issue a high priority, so other packages depending on you could benefit from your bug fixes and new features.

You can find below the list of errors reported by semantic-release. Each one of them has to be resolved in order to automatically publish your package. I’m sure you can resolve this 💪.

Errors are usually caused by a misconfiguration or an authentication problem. With each error reported below you will find explanation and guidance to help you to resolve it.

Once all the errors are resolved, semantic-release will release your package the next time you push a commit to the master branch. You can also manually restart the failed CI job that runs semantic-release.

If you are not sure how to resolve this, here is some links that can help you:

• Usage documentation
• Frequently Asked Questions
• Support channels

If those don’t help, or if this issue is reporting something you think isn’t right, you can always ask the humans behind semantic-release.

---

Invalid npm token.

The npm token configured in the NPM_TOKEN environment variable must be a valid token allowing to publish to the registry https://registry.npmjs.org/.

If you are using Two-Factor Authentication, make configure the auth-only level is supported. semantic-release cannot publish with the default auth-and-writes level.

Please make sure to set the NPM_TOKEN environment variable in your CI with the exact value of the npm token.

---

Good luck with your project ✨

Your semantic-release bot 📦🚀

Question

@streamich
sorry: I see no email to address this rather than in issues:

How well (and with how much work) would this assembler be able to mock/run the Ethereum EVM? https://github.com/ethereumjs/ethereumjs-vm
the opcodes are in https://github.com/ethereumjs/ethereumjs-vm/blob/master/lib/opcodes.js