Swiftpack.co - rkreutz/HeliosKit as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by rkreutz.
rkreutz/HeliosKit 0.5.1
Swift wrapper for Helios, a fast, secure and portable light client for Ethereum
⭐️ 9
🕓 6 weeks ago
iOS macOS
.package(url: "https://github.com/rkreutz/HeliosKit.git", from: "0.5.1")


Swift 5.7 Platforms Swift Package Manager License: MIT GitHub tag

Helios is a fully trustless, efficient, and portable Ethereum light client written in Rust.

Helios converts an untrusted centralized RPC endpoint into a safe unmanipulable local RPC for its users. It syncs in seconds, requires no storage, and is lightweight enough to run on mobile devices.

This Swift Package is a wrapper around Helios' Rust library.


Add the package declaration to your project's manifest dependencies array:

.package(url: "https://github.com/rkreutz/HeliosKit.git", from: "0.1.0")


You can start a client with:

let rpcURL = // URL to the unsafe RPC
try await Helios.shared.start(rpcURL: rpcURL)

Have in mind that only one client can be running at all times.

Once the client is up and running you can start doing RPC calls to it, it will be listening to

You may also use the library to call methods from the RPC with:

let (data, _) = try await Helios.shared.call(method: "eth_getBalance", params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"])
let response = String(data: data, encoding: .utf8)!
print(response) // {"jsonrpc":"2.0","result":"0x0000000000000000000000000000000000000000000000000000000000000000","id":...}

To shutdown your client gracefully, use the shutdown() method:

await Helios.shared.shutdown()


You may enable logging of the Rust lib with an environment var at runtime (RUST_LOG). The library uses Rust's env_logger framework, so you may set the desired levels accordingly.

Screen Shot 2022-12-13 at 18 31 46

Building locally

There is a build_xcframework.sh script in the repo which can be used to build the xcframework for the helios rust library, this will create the XCFramework and place it (along with the Swift bridging files and checksum) in the .build/helios-rs/build directory. You may specify which version you would like to build and provide an additional parameter to the script to build a debug or release framework.

> zsh build_xcframework.sh 0.1.3 debug # .build/helios-rs/build/0.1.3/debug/helios.xcframework

> zsh build_xcframework.sh 0.1.3 # .build/helios-rs/build/0.1.3/debug/helios.xcframework

> zsh build_xcframework.sh debug # No version specified, defaults to latest

> zsh build_xcframework.sh # No version specified, defaults to latest

Running the test target

To be able to compile the test target you must create a Config.swift file (you can just copy and rename Config.swift.example) and add the RPC URL you have for mainnet.

You may optionaly provide a rawTransaction data to test sendRawTransaction(_:).


Stars: 9
Last commit: 5 weeks ago
Advertisement: IndiePitcher.com - Cold Email Software for Startups

Release Notes

5 weeks ago

Includes Sepolia support and ability to customize local RPC IP and Port.

Helios 0.5.1

  • Hotfix to ensure all tx fields are populated correctly

Includes Helios 0.5.0

  • Internal refactoring
  • Lots and lots of bug fixes and improvements
  • Working WASM support and TS bindings.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics