npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

huffc

v0.0.25

Published

A low level programming language for the Ethereum Virtual Machine

Downloads

87

Readme

The Huff Programming Language

Huff logo.

Huff is a low-level programming language designed for developing highly optimized smart contracts that run on the Ethereum Virtual Machine (EVM). Huff does not hide the inner workings of the EVM. Instead, Huff exposes its programming stack to the developer for manual manipulation.

Rather than having functions, Huff has macros - individual blocks of bytecode that can be rigorously tested and evaluated using the Huff runtime testing suite.

Initially developed by the Aztec Protocol team, Huff was created to write Weierstrudel. Weierstrudel is an on-chain elliptical curve arithmetic library that requires incredibly optimized code that neither Solidity nor Yul could provide.

While EVM experts can use Huff to write highly-efficient smart contracts for use in production, it can also serve as a way for beginners to learn more about the EVM.

Examples

For usage examples, see the huff-examples repository.

Installation

Prerequisities

Make sure you have the following programs installed:

Steps

This is how to create the contract bytecode to output Hello, World! in Huff.

  1. Install Huff globally:

    yarn global add huffc

Note: You may need to add yarn to your system's path to access globally installed packages. See the yarn docs on global for more details.

Hello World

  1. Create a file called hello-world.huff and enter the following content:

    #define macro MAIN() = takes (0) returns (0) {
        0x48656c6c6f2c20776f726c6421 0x00 mstore // Store "Hello, World!" in memory.
        0x1a 0x00 return // Return 26 bytes starting from memory pointer 0.
    }
  2. Use huffc to compile the contract and output bytecode:

    huffc hello-world.huff --bytecode

    This will output something like:

    6100168061000d6000396000f36c48656c6c6f2c20776f726c6421600052601a6000f3 

More help

Run huffc --help to view a full list of arguments:

huffc --help

> Usage: huffc [options]
> 
> Options:
>   -V, --version                    output the version number
>   -V, --version                    Show the version and exit
>   --base-path <path>               The base path to the contracts (default: "./")
>   --output-directory <output-dir>  The output directory (default: "./")
>   --bytecode                       Generate and log bytecode (default: false)
>   -o, output                       The output file
>   -p, --paste                      Paste the output to the terminal
>   -h, --help                       display help for command