From 5217651f678e9e6f8ecacdb4cb755d8a4f2f838e Mon Sep 17 00:00:00 2001 From: Hugo Dias Date: Tue, 29 Jul 2025 12:20:58 +0100 Subject: [PATCH 1/4] feat: update javascript tools to mention iso-filecoin --- reference/general/README.md | 16 ++++++------- reference/general/tools.md | 47 ++++++++++++++++++++++++++++++++----- 2 files changed, 48 insertions(+), 15 deletions(-) diff --git a/reference/general/README.md b/reference/general/README.md index 666e39dfd..a43fcbc59 100644 --- a/reference/general/README.md +++ b/reference/general/README.md @@ -81,17 +81,17 @@ Developer tools, API clients & storage services that developers can use to build * [Fleek’s tools](https://fleek.xyz/) - provides access to Fleek’s hosted services using IPFS, Filecoin, Ethereum, etc. * [Akave](https://www.akave.ai/) is "revolutionizing data management with a decentralized, modular solution that combines the robust storage of Filecoin with cutting-edge encryption and easy-to-use interfaces." +### JavaScript tools -### Message signing tools +* [iso-filecoin](https://github.com/hugomrdias/filecoin/tree/main/packages/iso-filecoin) - Filecoin Javascript Standard Library. Used by the [Metamask Filecoin Wallet](https://github.com/filecoin-project/filsnap) and [Ledger Live Filecoin app](https://www.ledger.com/coin/wallet/filecoin). +* [iso-filecoin-react](https://github.com/hugomrdias/filecoin/tree/main/packages/iso-filecoin-react) - React hooks and context to easily integrate Filecoin wallet interactions into your React applications. It works seamlessly with the wallet adapters from iso-filecoin-wallets. -* [Filecoin Signing Tools](../built-in-actors/) - _**Recommended**_ a pure JS or Rust / WASM / JSONRPC library for creating signed messages apart from a Filecoin node. - * For an open source example of how to use it see the [Glif web wallet](https://github.com/glifio/wallet) on GitHub. -* [Filecoin JS Signer](https://github.com/blitslabs/filecoin-js-signer) - \[_last update: June 2021_] pure TS / JS library for creating signed messages and interacting with Filecoin’s built-in Actors (like Payment Channel and Multisig), used by the [Filecoin Loans grant project](https://github.com/blitslabs/filecoin.loans-monorepo). - * On npm at [`@blitslabs/filecoin-js-signer`](https://www.npmjs.com/package/@blitslabs/filecoin-js-signer) +Check out the [documentation website](https://filecoin.hugomrdias.dev/) for more information. ### Wallet-related tools -* [FilSnap MetaMask Plugin](https://metamask.io/flask/) - MetaMask has a new plugin system currently still in beta that developers can try out. The MM UI will not change but Filecoin keys are in the MM vault. +* [Metamask Filecoin Wallet](https://github.com/filecoin-project/filsnap) - A MetaMask [Snap](https://snaps.metamask.io/snap/npm/filsnap/) to add Filecoin support to the MetaMask extension. Check out [filsnap.dev](https://filsnap.dev/) built with the [iso-filecoin](https://github.com/hugomrdias/filecoin/tree/main/packages/iso-filecoin) and [filsnap](https://github.com/filecoin-project/filsnap) libraries. +* [iso-filecoin-wallets](https://github.com/hugomrdias/filecoin/tree/main/packages/iso-filecoin-wallets) - Filecoin wallet adapters to interact with different types of Filecoin wallets through a common interface. Supports Ledger, MetaMask Filecoin Wallet, and more. ### Node Infrastructure & APIs @@ -110,9 +110,7 @@ For running a node cluster of load balanced Lotus JSON RPC API endpoints. **Filecoin API clients** -* [`Filecoin.js`](https://github.com/filecoin-shipyard/filecoin.js) (outdated) - higher-level JS library for interacting with Lotus via JSON-RPC API. -* [`js-lotus-client`](https://github.com/filecoin-shipyard/js-lotus-client) - lower-level JS wrapper for basic parsing of the Lotus JSON RPC API. -* [`lotus-json-rpc-provider`](https://www.npmjs.com/package/@coinsummer/lotus-jsonrpc-provider) (outdated) - wraps the Lotus API in TypeScript. +* [iso-filecoin](https://github.com/hugomrdias/filecoin/tree/main/packages/iso-filecoin) - Filecoin Javascript Standard Library includes an API client for the Lotus JSON-RPC API. **Storage provider index API** diff --git a/reference/general/tools.md b/reference/general/tools.md index 6147c90df..e199ce84b 100644 --- a/reference/general/tools.md +++ b/reference/general/tools.md @@ -10,15 +10,50 @@ description: >- These infrastructure libraries and tools exist to speed up the development of software on top of the Filecoin network. -#### Filecoin signing tools +#### Filecoin Javascript Standard Library -The [Filecoin signing tools](./) provide basic functionality for signing Filecoin transactions in pure JavaScript, WASM and Rust. Currently, the Rust and WASM implementations support: +> Connect apps to the Filecoin blockchain with iso-filecoin. -* Secp256k1 -* BLS -* CBOR-JSON serialization of transactions +##### Features -Support for multisignature transaction signing is currently in progress, and the pure JavaScript implementation is less complete than the Rust and WASM implementations. +- Lightweight, performant and type-safe +- Support for RPC, Signature, Address, Token, Chain, Wallet and more. +- React hooks and context to easily integrate Filecoin wallets +- Wallet adapters for Ledger Filecoin App, MetaMask Filecoin Wallet, and more. + +##### Packages + +- [iso-filecoin](https://github.com/hugomrdias/filecoin/tree/main/packages/iso-filecoin) - Core package +- [iso-filecoin-react](https://github.com/hugomrdias/filecoin/tree/main/packages/iso-filecoin-react) - React hooks and context +- [iso-filecoin-wallets](https://github.com/hugomrdias/filecoin/tree/main/packages/iso-filecoin-wallets) - Wallet adapters + +##### Resources + +- [Documentation](https://filecoin.hugomrdias.dev/) + +#### ⨎ Filsnap + +> A MetaMask [Snap](https://snaps.metamask.io/snap/npm/filsnap/) to add Filecoin support to the MetaMask extension. + +##### Features + +- Enables dapps access to Filecoin accounts using Metamask. +- Manage Filecoin accounts, check balance, address, export private key and more. +- Send and receive FIL from native and FEVM addresses. +- Sign Filecoin messages and arbitrary data. +- Send Filecoin messages and estimate gas fees. +- Filecoin insights for FEVM transaction/signature requests. + +##### Resources + +- [Companion App](https://filsnap.dev/) +- [Documentation](https://filecoin-project.github.io/filsnap/) + +##### Packages + +- [filsnap](https://github.com/filecoin-project/filsnap/tree/master/packages/snap) - Filecoin snap for Metamask +- [filsnap-adapter](https://github.com/filecoin-project/filsnap/tree/master/packages/adapter) - Adapter to interact with Filsnap from a dapp +- [filsnap-adapter-react](https://github.com/filecoin-project/filsnap/tree/master/packages/adapter-react) - React hooks to interact with Filsnap from a dapp #### Filecoin addresses From b6e2eb8b92c51bdc91b2f72ed52e7d05ac11a0a2 Mon Sep 17 00:00:00 2001 From: Hugo Dias Date: Fri, 15 Aug 2025 17:31:48 +0100 Subject: [PATCH 2/4] chore: fix broken links --- .lycheeignore | 1 + networks/mainnet/explorers.md | 4 ---- storage-providers/skills/linux.md | 2 +- 3 files changed, 2 insertions(+), 5 deletions(-) create mode 100644 .lycheeignore diff --git a/.lycheeignore b/.lycheeignore new file mode 100644 index 000000000..8413fe9e1 --- /dev/null +++ b/.lycheeignore @@ -0,0 +1 @@ +*.w3s.link \ No newline at end of file diff --git a/networks/mainnet/explorers.md b/networks/mainnet/explorers.md index 80382cad7..184010ec1 100644 --- a/networks/mainnet/explorers.md +++ b/networks/mainnet/explorers.md @@ -21,10 +21,6 @@ Website: [filfox.info](https://filfox.info) Website: [filscan.io](https://filscan.io) -### Filutils - -Website: [filutils.com](https://www.filutils.com/en) - ### Starboard Website: [fvm.starboard.ventures](https://fvm.starboard.ventures/) diff --git a/storage-providers/skills/linux.md b/storage-providers/skills/linux.md index 4cf4f6993..d484e4f8d 100644 --- a/storage-providers/skills/linux.md +++ b/storage-providers/skills/linux.md @@ -57,7 +57,7 @@ sudo sysctl -p Diagnosing performance bottlenecks on a system is vital to keeping a well balanced [sealing pipeline](../architecture/sealing-pipeline.md). -There are many good resources to check out when it comes to Linux performance troubleshooting. Brendan Gregg’s [Linux performance analysis in 60 seconds](https://netflixtechblog.com/linux-performance-analysis-in-60-000-milliseconds-accc10403c55) is an excellent introduction. Each one of these commands deserves a chapter on its own but can be further researched in their man pages. +There are many good resources to check out when it comes to Linux performance troubleshooting. Brendan Gregg’s [Linux performance analysis in 60 seconds](https://www.brendangregg.com/blog/2015-12-03/linux-perf-60s-video.html) is an excellent introduction. Each one of these commands deserves a chapter on its own but can be further researched in their man pages. {% embed url="https://www.youtube.com/watch?v=ZdVpKx6Wmc8" %} From 08d303ad9d79796f11c43940d5ede39259bec95e Mon Sep 17 00:00:00 2001 From: Hugo Dias Date: Fri, 15 Aug 2025 17:36:56 +0100 Subject: [PATCH 3/4] chore: fix regex --- .lycheeignore | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.lycheeignore b/.lycheeignore index 8413fe9e1..cab287f51 100644 --- a/.lycheeignore +++ b/.lycheeignore @@ -1 +1 @@ -*.w3s.link \ No newline at end of file +/https?:\/\/(?:www\.)?[a-zA-Z0-9.-]+\.w3s\.link[^\s]*/ \ No newline at end of file From ffefe080b9509e87c04c20ae296593bb4f9cf097 Mon Sep 17 00:00:00 2001 From: Hugo Dias Date: Fri, 15 Aug 2025 17:43:59 +0100 Subject: [PATCH 4/4] chore: more --- .lycheeignore | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.lycheeignore b/.lycheeignore index cab287f51..01700b48a 100644 --- a/.lycheeignore +++ b/.lycheeignore @@ -1 +1 @@ -/https?:\/\/(?:www\.)?[a-zA-Z0-9.-]+\.w3s\.link[^\s]*/ \ No newline at end of file +https?:\/\/(?:www\.)?[a-zA-Z0-9.-]+\.w3s\.link[^\s]* \ No newline at end of file