Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion WELCOME.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,6 @@ layout:

Choose your own path to start exploring Filecoin:

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>💡 <strong>Learn the basics</strong></td><td>New to Filecoin and looking for foundational concepts? Start with the Basics section to understand the essentials and kick off your journey!</td><td></td><td><a href="getting-started/what-is-filecoin/">what-is-filecoin</a></td></tr><tr><td>🔧 <strong>Build with Filecoin</strong></td><td>Ready to develop on the Filecoin network? Head to the Developers section for guides and examples to help bring your project to life.</td><td></td><td><a href="core-concepts/filecoin-virtual-machine/">the-fvm.md</a></td></tr><tr><td>🏗️ <strong>Become a Storage Provider</strong></td><td>Thinking about running a provider node on Filecoin? Visit the Provider section for comprehensive guidance on getting started.</td><td></td><td><a href="storage-providers/basics/">basics</a></td></tr><tr><td>📊 <strong>Store data</strong></td><td>Looking to store large volumes of data? Explore the Store section to review the various storage options Filecoin offers.</td><td></td><td><a href="getting-started/what-is-filecoin/storage-model.md">storage-model.md</a></td></tr></tbody></table>
<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>💡 <strong>Learn the basics</strong></td><td>New to Filecoin and looking for foundational concepts? Start with the Basics section to understand the essentials and kick off your journey!</td><td></td><td><a href="getting-started/what-is-filecoin/">what-is-filecoin</a></td></tr><tr><td>🔧 <strong>Build with Filecoin</strong></td><td>Ready to develop on the Filecoin network? Head to the Developers section for guides and examples to help bring your project to life.</td><td></td><td><a href="core-concepts/filecoin-virtual-machine/">the-fvm.md</a></td></tr><tr><td>🏗️ <strong>Become a Storage Provider</strong></td><td>Thinking about running a provider node on Filecoin? Visit the Provider section for comprehensive guidance on getting started.</td><td></td><td><a href="storage-providers/getting-started.md">getting-started.md</a></td></tr><tr><td>📊 <strong>Store data</strong></td><td>Looking to store large volumes of data? Explore the Store section to review the various storage options Filecoin offers.</td><td></td><td><a href="getting-started/what-is-filecoin/storage-model.md">storage-model.md</a></td></tr></tbody></table>

[Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill_Page+URL=https://docs.filecoin.io/)
10 changes: 5 additions & 5 deletions build/advanced/fevm-indexers.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,12 @@ description: >-

# FEVM Indexers

> _Not to be confused with_ [_IPNI Indexer_](https://docs.filecoin.io/storage-providers/architecture/network-indexer)
> _Not to be confused with_ [_IPNI Indexer_](../../storage-providers/architecture/network-indexer.md)

Blockchain indexers are used for accessing blockchain data efficiently. They process and organize storage-optimized raw blockchain data into retrieve-optimized and well-queryable formats. This benefits developers and users looking to retrieve specific information because they don't need to:

1. Run their own [archival node](https://docs.filecoin.io/networks-and-tools/networks/mainnet/rpcs).
2. Parse entire blockchain histories to crawl for events that might not exist for thousands of [tipsets](https://docs.filecoin.io/core-concepts/filecoin-virtual-machine/blocks-and-tipsets#tipsets).
1. Run their own [archival node](../../networks-and-tools/networks/mainnet/rpcs.md).
2. Parse entire blockchain histories to crawl for events that might not exist for thousands of [tipsets](../../core-concepts/filecoin-virtual-machine/blocks-and-tipsets.md#tipsets).
3. Spend significant time required to retrieve data from the blockchain node.
4. Determine complex interconnections between smart contracts.
5. Spend substantial compute power to calculate advanced queries.
Expand Down Expand Up @@ -107,7 +107,7 @@ Use the Goldsky Playground or integrate it into your app to consume indexed data

#### Querying Subgraphs on Filecoin FEVM

There are many ways to query existing subgraphs, including numerous well-known libraries for [JavaScript](https://thegraph.com/docs/en/querying/querying-from-an-application/) and [Python](https://thegraph.com/docs/en/querying/querying-with-python/). But even without any third-party tooling, querying a subgraph is no more complicated than querying [RPC nodes](https://docs.filecoin.io/reference/json-rpc). The only complexity is that you have to know the schema of the subgraph beforehand, similar to knowing SQL database tables and columns before being able to query them. Luckily, The Graph provides several ways to discover the subgraph schema. The most convenient one is called the ["Playground"](https://graphql.org/blog/2020-04-03-graphiql-graphql-playground/), and it is available upon a GET request to the subgraph query URL. Alternatively, you may use the discovery method that exists on every subgraph, called the [Introspection Query](https://graphql.org/learn/introspection/).
There are many ways to query existing subgraphs, including numerous well-known libraries for [JavaScript](https://thegraph.com/docs/en/querying/querying-from-an-application/) and [Python](https://thegraph.com/docs/en/querying/querying-with-python/). But even without any third-party tooling, querying a subgraph is no more complicated than querying [RPC nodes](../../reference/json-rpc/README.md). The only complexity is that you have to know the schema of the subgraph beforehand, similar to knowing SQL database tables and columns before being able to query them. Luckily, The Graph provides several ways to discover the subgraph schema. The most convenient one is called the ["Playground"](https://graphql.org/blog/2020-04-03-graphiql-graphql-playground/), and it is available upon a GET request to the subgraph query URL. Alternatively, you may use the discovery method that exists on every subgraph, called the [Introspection Query](https://graphql.org/learn/introspection/).

#### Developing Subgraphs on Filecoin FEVM

Expand All @@ -122,7 +122,7 @@ Just as with database data queried through SQL, subgraphs have to be stored some
[Protofire (aka Glif Nodes)](https://api.node.glif.io) offers public access to The Graph services, simplifying the process of deploying and managing subgraphs.

1. **Connect Your Wallet**
* On the [Protofire (Glif Nodes) platform - SUBGRAPHS](https://api.node.glif.io/graph), connect your [Filecoin-compatible wallet](https://docs.filecoin.io/networks-and-tools/assets/wallets).
* On the [Protofire (Glif Nodes) platform - SUBGRAPHS](https://api.node.glif.io/graph), connect your [Filecoin-compatible wallet](../../networks-and-tools/assets/wallets.md).
2. **Create an API Key**
* Choose the **API keys** tab.
* Click **Create new key**.
Expand Down
8 changes: 4 additions & 4 deletions build/advanced/multisig.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ There are several multisig wallet implementations on Filecoin. Builders can inte

### Filecoin Native Multisig

The Filecoin Native [MultisigActor](/core-concepts/filecoin-virtual-machine/actors#multisigactor) is a built-in actor that does not interact directly with the Filecoin EVM. Like other Filecoin actors, native multisig addresses begin with `f2` and represent a group of transaction signers with a maximum of 256 signers. Signers may be external users or the MultisigActor itself and can include `f1` and `f3` [addresses](https://docs.filecoin.io/core-concepts/filecoin-virtual-machine/addresses).
The Filecoin Native [MultisigActor](../../core-concepts/filecoin-virtual-machine/actors.md#multisigactor) is a built-in actor that does not interact directly with the Filecoin EVM. Like other Filecoin actors, native multisig addresses begin with `f2` and represent a group of transaction signers with a maximum of 256 signers. Signers may be external users or the MultisigActor itself and can include `f1` and `f3` [addresses](../../core-concepts/filecoin-virtual-machine/addresses.md).

#### Filecoin Native Multisig UIs

Expand All @@ -38,7 +38,7 @@ The Filecoin Native [MultisigActor](/core-concepts/filecoin-virtual-machine/acto

A web UI for the Safe multisig on Filecoin is available at:

- [https://safe.filecoin.io](https://safe.filecoin.io) - the default network is set to [Filecoin Mainnet](https://docs.filecoin.io/networks-and-tools/networks/mainnet)
- [https://safe.filecoin.io](https://safe.filecoin.io) - the default network is set to [Filecoin Mainnet](../../networks-and-tools/networks/mainnet/README.md)

![FilecoinSafeUI](https://github.com/user-attachments/assets/60044b7a-e6fa-4085-bcd9-80bc186975c3)

Expand All @@ -59,8 +59,8 @@ A web UI for the Safe multisig on Filecoin is available at:
#### Safe Transaction Service

The [Safe transaction service](https://docs.safe.global/core-api/api-safe-transaction-service) on Filecoin is available at:
- [https://transaction.safe.filecoin.io](https://transaction.safe.filecoin.io) on [Filecoin Mainnet](https://docs.filecoin.io/networks-and-tools/networks/mainnet)
- [https://transaction-testnet.safe.filecoin.io](https://transaction-testnet.safe.filecoin.io) on [Filecoin Calibration testnet](https://docs.filecoin.io/networks-and-tools/networks/calibration)
- [https://transaction.safe.filecoin.io](https://transaction.safe.filecoin.io) on [Filecoin Mainnet](../../networks-and-tools/networks/mainnet/README.md)
- [https://transaction-testnet.safe.filecoin.io](https://transaction-testnet.safe.filecoin.io) on [Filecoin Calibration testnet](../../networks-and-tools/networks/calibration/README.md)

- Note:
- Faster finality is coming to Filecoin soon. For now, the Filecoin Safe transaction service sets `ETH_REORG_BLOCKS` to 60 blocks (i.e. Filecoin epochs) (30min) based on [FRC-0089](https://github.com/filecoin-project/FIPs/blob/master/FRCs/frc-0089.md) but users may want to wait 900 epochs (~7.5h) for full finality.
Expand Down
2 changes: 1 addition & 1 deletion build/cookbook/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,6 @@ Each recipe contains:

### **Quick Start**

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><em><mark style="color:blue;"><strong>Data Storage</strong></mark></em></td><td>Recipes for programmable storage and retrieval of your public or private data on Filecoin.</td><td></td><td><a href="store-data/">store-data</a></td><td><a href="../../.gitbook/assets/fvm-1.png">fvm-1.png</a></td></tr></tbody></table>
<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><em><mark style="color:blue;"><strong>Data Storage</strong></mark></em></td><td>Recipes for programmable storage and retrieval of your public or private data on Filecoin.</td><td></td><td><a href="store-data.md">store-data.md</a></td><td><a href="../../.gitbook/assets/fvm-1.png">fvm-1.png</a></td></tr></tbody></table>

[Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill_Page+URL=https://docs.filecoin.io/build/cookbook/overview)
20 changes: 10 additions & 10 deletions build/developing-contracts/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,16 +7,16 @@ description: >-
# Developing contracts

This section covers how to build dApps by writing smart contracts in the Filecoin Virtual Machine. The docs in this section explain:
- How to [get test tokens](https://docs.filecoin.io/build/developing-contracts/get-test-tokens), called tFIL, from a faucet.
- How to set up [Remix](https://docs.filecoin.io/build/development-frameworks/remix), to make use of Ethereum tooling while building Filecoin dApps.
- How to set up [Hardhat](https://docs.filecoin.io/build/development-frameworks/hardhat), to build FVM dApps in an environment familiar to Ethereum developers.
- How to make use of [Foundry](https://docs.filecoin.io/build/development-frameworks/foundry), expanding the utilities available for interacting with FVM contracts.
- Where to [find contract templates](https://docs.filecoin.io/build/developing-contracts/solidity-libraries) from a range of third party Solidity libraries.
- How to [Call built-in actors](https://docs.filecoin.io/build/developing-contracts/call-built-in-actors) using the Protocol API or the Solidity Library.
- How to make use of the Filecoin [Solidity Libraries](https://docs.filecoin.io/build/developing-contracts/filecoin.sol) to build FVM dApps using a language familiar to Ethereum developers.
- How to perform a storage deal using the [direct dealmaking client contract](https://docs.filecoin.io/legacy/smart-contracts/developing-contracts/client-contract-tutorial).
- How to [verify a contract](https://docs.filecoin.io/build/verification/) using one of Filecoin's many block explorers.
- The [best practices](https://docs.filecoin.io/build/developing-contracts/best-practices) for building FVM dApps.
- How to [get test tokens](./get-test-tokens.md), called tFIL, from a faucet.
- How to set up [Remix](../development-frameworks/remix.md), to make use of Ethereum tooling while building Filecoin dApps.
- How to set up [Hardhat](../development-frameworks/hardhat.md), to build FVM dApps in an environment familiar to Ethereum developers.
- How to make use of [Foundry](../development-frameworks/foundry.md), expanding the utilities available for interacting with FVM contracts.
- Where to [find contract templates](./solidity-libraries.md) from a range of third party Solidity libraries.
- How to [Call built-in actors](./call-built-in-actors.md) using the Protocol API or the Solidity Library.
- How to make use of the Filecoin [Solidity Libraries](./filecoin.sol.md) to build FVM dApps using a language familiar to Ethereum developers.
- How to perform a storage deal using the [direct dealmaking client contract](../../legacy/smart-contracts/developing-contracts/client-contract-tutorial.md).
- How to [verify a contract](../verification/README.md) using one of Filecoin's many block explorers.
- The [best practices](./best-practices.md) for building FVM dApps.


[Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill\_Page+URL=https://docs.filecoin.io/build/developing-contracts)
8 changes: 4 additions & 4 deletions build/developing-contracts/call-built-in-actors.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,9 +44,9 @@ Smart contracts can access built-in actor methods with the `filecoin.sol` librar

To invoke built-in actor methods using `filecoin.sol`, follow these steps:

1. Review the [available actors and methods](https://docs.filecoin.io/build/developing-contracts/call-built-in-actors/#available-actors-and-methods).
2. [Import `filecoin.sol`](https://docs.filecoin.io/build/developing-contracts/call-built-in-actors/#import-filecoinsol).
3. [Call a built-in actor](https://docs.filecoin.io/build/developing-contracts/call-built-in-actors/#call-a-built-in-actor).
1. Review the [available actors and methods](#available-actors-and-methods).
2. [Import `filecoin.sol`](#import-filecoinsol).
3. [Call a built-in actor](#call-a-built-in-actor).

### Available actors and methods

Expand Down Expand Up @@ -211,7 +211,7 @@ The majority of the Account, DataCap, Storage Market, Miner, Storage Owner and V

### Import filecoin.sol

The `filecoin.sol` library is embeddable into your smart contract, which means it does not need be present on chain first. Instead, you can just import the library and call the available methods. The `filecoin.sol` library can be [added via `npm`](https://docs.filecoin.io/build/developing-contracts/call-built-in-actors/#import-filecoinsol-with-npm) or [manually imported](https://docs.filecoin.io/build/developing-contracts/call-built-in-actors/#import-filecoinsol-manually) into your contract. The `npm`-based import is simpler, and is recommended.
The `filecoin.sol` library is embeddable into your smart contract, which means it does not need be present on chain first. Instead, you can just import the library and call the available methods. The `filecoin.sol` library can be [added via `npm`](#import-filecoinsol-with-npm) or [manually imported](#import-filecoinsol-manually) into your contract. The `npm`-based import is simpler, and is recommended.

#### **Import filecoin.sol with npm**

Expand Down
6 changes: 3 additions & 3 deletions build/developing-contracts/get-test-tokens.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,9 @@ That’s all there is to it! Getting `tFil` is easy!

## Local testnet

Before we begin, you must have a local testnet running. Follow the [Run a local network guide](https://docs.filecoin.io/networks-and-tools/networks/local-testnet/set-up/) if you haven’t got a local testnet set up yet.
Before we begin, you must have a local testnet running. Follow the [Run a local network guide](../../networks-and-tools/networks/local-testnet/README.md) if you haven’t got a local testnet set up yet.

1. Change directory to where you created the `lotus` and `lotus-miner` binaries. If you followed the [Run a local network guide](https://docs.filecoin.io/networks-and-tools/networks/local-testnet/set-up/) these binaries will be in `~/lotus-devnet`:
1. Change directory to where you created the `lotus` and `lotus-miner` binaries. If you followed the [Run a local network guide](../../networks-and-tools/networks/local-testnet/README.md) these binaries will be in `~/lotus-devnet`:

```shell
cd ~/lotus-devnet
Expand Down Expand Up @@ -66,7 +66,7 @@ For example:
./lotus wallet balance t1snly7vh4mjtjznwze56ihrdhzfwvbajywwmrenq
```

If you want to manage your local testnet tokens in MetaMask you will need to create a `t4` address. You can create a `t4` address using `lotus wallet new deleated`. Once you have a `t4` address you can [connect MetaMask to your local testnet](https://docs.filecoin.io/networks-and-tools/assets/metamask-setup/) to see the new balance within the MetaMask extension.
If you want to manage your local testnet tokens in MetaMask you will need to create a `t4` address. You can create a `t4` address using `lotus wallet new deleated`. Once you have a `t4` address you can [connect MetaMask to your local testnet](../../networks-and-tools/assets/metamask-setup.md) to see the new balance within the MetaMask extension.

Copilot AI Apr 6, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The command in the inline code sample uses lotus wallet new deleated, which appears to be a typo; the Lotus subcommand is delegated. As written, users will get an “unknown address type”/usage error. Correct the subcommand spelling.

Suggested change
If you want to manage your local testnet tokens in MetaMask you will need to create a `t4` address. You can create a `t4` address using `lotus wallet new deleated`. Once you have a `t4` address you can [connect MetaMask to your local testnet](../../networks-and-tools/assets/metamask-setup.md) to see the new balance within the MetaMask extension.
If you want to manage your local testnet tokens in MetaMask you will need to create a `t4` address. You can create a `t4` address using `lotus wallet new delegated`. Once you have a `t4` address you can [connect MetaMask to your local testnet](../../networks-and-tools/assets/metamask-setup.md) to see the new balance within the MetaMask extension.

Copilot uses AI. Check for mistakes.



Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,4 +72,4 @@ When calling an Ethereum method that allows the user to ask for the `latest` blo



[Was this page helpful?](https://docs.filecoin.io/build/architecture/filecoin-evm-runtime/difference-with-ethereum)
[Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill\_Page+URL=https://docs.filecoin.io/core-concepts/filecoin-evm-runtime/difference-with-ethereum)
Loading
Loading