Filecoin 백서

Filecoin

원문

bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 52쪽 중 1쪽

# Welcome to Filecoin Docs Filecoin is a decentralized, peer-to-peer network enabling anyone to store and retrieve data over the internet. Economic incentives are built in, ensuring files are stored and accessible reliably over 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>Get started</strong></td><td>New to Filecoin and looking for foundational concepts? Start with the Getting Started 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 on Filecoin</strong></td><td>Ready to develop on the Filecoin network? Head to the Build on Filecoin section for smart contracts, storage integrations, and Filecoin Onchain Cloud.</td><td></td><td><a href="/build-on-filecoin/getting-started">Getting started</a></td></tr><tr><td>☁️ <strong>Filecoin Onchain Cloud</strong></td><td>Store and retrieve application data with verifiable storage, automated payments, and the Synapse SDK.</td><td></td><td><a href="/build-on-filecoin/filecoin-onchain-cloud">Filecoin Onchain Cloud</a></td></tr><tr><td>🏗️ <strong>Provide storage</strong></td><td>Thinking about running a provider node on Filecoin? Visit the Provide Storage section for comprehensive guidance on getting started.</td><td></td><td><a href="/provide-storage/getting-started">Plan your Filecoin storage provider business</a></td></tr><tr><td>📊 <strong>Store data</strong></td><td>Looking to store large volumes of data? See how storage works to review the various storage options Filecoin offers.</td><td></td><td><a href="/getting-started/how-storage-works/upload-to-filecoin">Upload to Filecoin</a></td></tr></tbody></table> [Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill_Page+URL=https://docs.filecoin.io/) # What is Filecoin This section offers a detailed overview of Filecoin for developers, serving as a go-to reference for their needs. ### Introduction to Filecoin Filecoin is a peer-to-peer network that enables reliable, decentralized file storage through built-in economic incentives and cryptographic proofs. Clients, or users, pay any number of storage providers, or data centers, to store the client's data --storage providers then provide cryptographic proofs daily as evidence to the clients that the data is still at the data center. Storage providers lock a certain amount of Filecoin as collateral --should they repeatedly fail to provide a proof, their collateral gets burned, serving as a strong deterrent from the data center losing the data. Anyone can join Filecoin as a client looking to store their data, or as a storage provider offering storage services. Storage availability and pricing aren’t controlled by any single entity; instead, Filecoin fosters an open market for file storage and retrieval accessible to all. Clients can review the history of each storage provider, along with their credentials and compliance record, before choosing to store their data with them. Note that most Filecoin nodes are [IPFS protocol](https://docs.ipfs.tech/) nodes. IPFS is a open system, a hypermedia protocol, to manage data without a central server that makes use of [content addressing](https://docs.ipfs.tech/concepts/content-addressing/) to provide permanent data references without dependency on specific devices or cloud providers. A client who knows the content address (CID) of their file can retrieve it from any IPFS node (or Filecoin storage provider) that currently has a copy and is able to serve it. Given a CID, the [CID Contact](https://cid.contact/) network indexer will locate and providing routing details for the relevant file. Historically, IPFS node operators offered pinning services to the community out of interest and often for free, meaning there was no financial incentive for the IPFS node operators to stay online or keep a given file for a long period of time. Filecoin solves this issue by introducing an incentive layer (clients pay storage providers for long term data center use) to ensure more reliable long term cold storage. Since most Filecoin nodes are also IPFS nodes, they can pin a hot copy of the given file to the IPFS node to allow the client to easily retrieve the file later. Filecoin is used as a storage solution for a range of products, including from Web3-native NFT storage, incentivized permanent storage, and archival traditional Web2 datasets. For instance, [NFT.Storage](https://nft.storage/) leverages Filecoin for NFT content and metadata storage. Organizations such as the [Shoah Foundation](https://sfi.usc.edu/) and the [Internet Archive](https://archive.org/) use Filecoin for content preservation and backup. Filecoin is compatible with various data types, including audio and video files. This versatility allows Web3 platforms like [Audius](https://audius.co/) and [Huddle01](https://huddle01.com/) to use Filecoin as a decentralized storage backend for music streaming and video conferencing. [Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill_Page+URL=https://docs.filecoin.io/getting-started/what-is-filecoin) # Crypto-economics Crypto-economics is the study of how cryptocurrency can incentivize usage of a blockchain network. This page covers how Filecoin manages incentivization within the network. ## Native currency Filecoin’s native currency, FIL, is a utility token that incentivizes persistent storage on the Filecoin network. Storage providers earn FIL by offering reliable storage services or committing storage capacity to the network. With a maximum circulating supply of 2 billion FIL, no more than 2 billion Filecoin will ever exist. As a utility token aligned with the network’s long-term growth, Filecoin issuance depends on the network’s provable utility and growth. Most of the Filecoin supply is only minted as the network achieves specific growth and utility milestones. Filecoin uses a dual minting model for block reward distribution: ## Baseline minting Up to 770 million FIL tokens are minted based on network performance. Full release of these tokens would only occur if the Filecoin network reaches a yottabyte of storage capacity within 20 years, approximately 1,000 times the capacity of today’s cloud storage. ## Simple minting An additional 330 million FIL tokens are released on a 6-year half-life schedule, with 97% of these tokens projected to be released over about 30 years. Additionally, 300 million FIL tokens are held in a mining reserve to incentivize future mining models. ## Vesting Mining rewards are subject to a vesting schedule to support long-term network alignment. For instance, 75% of block rewards earned by miners vest linearly over 180 days, while 25% are immediately accessible, improving miner cash flow and profitability. Note that if the miner has incurred "[fee debt](/provide-storage/filecoin-economics/slashing)," the immediately accessible block rewards will automatically go towards paying down those fees. A certain portion of initially printed FIL tokens are vested to Protocol Labs teams and the Filecoin Foundation over six years, and to SAFT investors over three years, as outlined in the [vesting schedule](https://observablehq.com/@starboard/a-primer-to-filecoin-circulating-supply/2). To learn more about Filecoin block rewards vesting, review [FIP004: Liquidity Improvement for Storage Miners](https://github.com/filecoin-project/FIPs/blob/master/FIPS/fip-0004.md). ## Collateral and slashing To ensure network security and reliable storage, storage providers must lock FIL as pledge collateral during block reward mining. Pledge collateral is based on projected block rewards a miner could earn. Collateral and all earned rewards are subject to slashing if the storage fails to meet reliability standards throughout a sector’s lifecycle. ## Total supply FIL’s maximum circulating supply is capped at 2 billion FIL. However, this maximum will never be reached, as a portion of FIL is permanently removed from circulation through gas fees, penalties, and other mechanisms. [Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill_Page+URL=https://docs.filecoin.io/getting-started/what-is-filecoin/crypto-economics) # Blockchain A blockchain is a distributed database shared among nodes in a computer network. This page covers the design and functions of the Filecoin blockchain. ## Blockchain ### Tipsets A tipset is a set of blocks with the same height, allowing multiple storage providers to produce blocks in each epoch, increasing network throughput. The Filecoin blockchain consists of a chain of tipsets rather than individual blocks. Each tipset is assigned a weight, enabling the consensus protocol to guide nodes to build on the heaviest chain and preventing interference from nodes attempting to produce invalid blocks. ### Actors Actors are ‘objects’ within the Filecoin network, each with a state and a set of methods for interaction, that pass messages to each other and ensure the system operates appropiately. #### Built-in actors Several built-in system actors power the Filecoin network as a decentralized storage network: * **Init actor**: Initializes new actors and records the network name. * **Cron actor**: Scheduler that runs critical functions at every epoch. * **Account actor**: Manages user accounts (non-singleton). * **Reward actor**: Manages block rewards and token vesting (singleton). * **Storage miner actor**: Manages storage mining operations and validates storage proofs. * **Storage power actor**: Tracks storage power allocation for each provider. * **Storage market actor**: Manages storage deals. * **Multisig actor**: Handles Filecoin multi-signature wallet operations. * **Payment channel actor**: Sets up and settles payment channel funds. * **Datacap actor**: Manages datacap tokens. * **Verified registry actor**: Manages verified clients. * **Ethereum Address Manager (EAM) actor**: Assigns Ethereum-compatible addresses on Filecoin, including EVM smart contract addresses. * **Ethereum Virtual Machine (EVM) account actor**: Represents an external Ethereum identity backed by a secp256k1 key. * **System actor**: General system actor. ### Nodes Filecoin nodes are categorized by the services they provide to the storage network, including chain verifier nodes, client nodes, storage provider nodes, and retrieval provider nodes. All participating nodes must provide chain verification services. Filecoin supports multiple protocol implementations to enhance security and resilience. Active implementations include: * [Lotus](https://lotus.filecoin.io/) * [Venus](https://github.com/filecoin-project/venus) * [Forest](https://github.com/ChainSafe/forest) ### Addresses In the Filecoin network, addresses identify actors in the Filecoin state. Each address encodes information about the corresponding actor, making it easy to use and resistant to errors. Filecoin has five address types. Mainnet addresses start with `f`, and Testnet addresses start with `t`. * **`f0/t0`**: ID address for an actor in a human-readable format, such as `f0123261` for a storage provider. * **`f1/t1`**: secp256k1 wallet address, generated from an encrypted secp256k1 public key. * **`f2/t2`**: Address assigned to an actor in a way that ensures stability across network forks. * **`f3/t3`**: BLS wallet address, generated from a BLS public key. * **`f4/t4`**: Address created and assigned to user-defined actors by customizable "address management" actors. This address can receive funds before an actor is deployed. * **`f410/t410`**: Address space managed by the Ethereum Address Manager (EAM) actor, allowing Ethereum-compatible addresses to interact seamlessly with the Filecoin network. Ethereum addresses can be cast as `f410/t410` addresses and vice versa, enabling compatibility with existing Ethereum tools. ### Consensus #### Expected consensus Expected Consensus (EC) is the probabilistic, Byzantine fault-tolerant consensus algorithm underlying Filecoin. EC conducts a leader election among storage providers each epoch to determine which provider submits a block. Similar to proof-of-stake, Filecoin’s leader election relies on proof-of-storage, meaning the probability of being elected depends on how much provable storage a miner contributes to the network --measured in something called "storage power". The consensus process uses [Drand](https://drand.love) as a randomness beacon for leader election, ensuring the leader election is secret, fair, and verifiable. Election participants and their storage power are drawn from a data structure called the "Power Table", which is continuously calculated and maintained by the storage power actor. Ultimately, the EC process ends by gathering all valid blocks produced in an epoch to a tipset, applying a weighting function to select the heaviest chain, and adding the tipset to the heaviest chain accordingly. #### Block production process The block production process for each epoch is as follows: * Elect leaders from eligible miners. * Miners check if they are elected. * Elected miners generate WinningPoSt using randomness. * Miners build and propagate a block. * Verify the winning miner and election. * Select the heaviest chain to add the tipset. #### Finality EC enforces soft finality, where miners at round `N` reject blocks forking off before round `N - F` (where `F` is set to `900`). This ensures finality without compromising chain availability. ### Proofs Filecoin operates on proof-of-storage, where miners offer storage space and provide proofs to verify data storage. #### Proof of replication With proof-of-replication (PoRep), storage providers prove they have created a unique copy of the client’s data for the network. #### Proof of spacetime Storage providers must continuously prove that they are storing clients' data throughout the entire duration of the storage deal. The proof-of-spacetime (PoSt) process includes two types of challenges: * **Winning PoSt**: Verifies that a storage provider holds a copy of the data at a specific point in time. * **Window PoSt**: Confirms that the data has been consistently stored over a defined period. #### Slashing If storage providers fail to maintain reliable uptime or act maliciously, they face penalties through a process called slashing. Filecoin enforces two types of slashing: * **Storage Fault Slashing**: Penalizes providers who fail to maintain healthy and reliable storage sectors. * **Consensus Fault Slashing**: Penalizes providers attempting to disrupt the security or availability of the consensus process. [Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill_Page+URL=https://docs.filecoin.io/getting-started/what-is-filecoin/blockchain) # Storage model A storage model defines how data is stored within a system. This page covers the basic aspects of Filecoin’s storage model. The Filecoin storage model consists of three main components: * Providers * Deals * Sectors ## Providers Providers offer storage and retrieval services to network users. There are two types of providers: * Storage Providers * Retrieval Providers ### Storage providers Storage providers, often called SPs, are responsible for storing files and data for clients on the network. They also provide cryptographic proofs to verify that data is stored securely. The majority of providers on the Filecoin network are SPs. ### Retrieval providers Retrieval providers, or RPs, specialize in delivering quick access to data rather than long-term storage. While many storage providers also offer retrieval services, stand-alone RPs are increasingly joining the network to enhance data accessibility. ## Deals In the Filecoin network, SPs and RPs offer storage or retrieval services to clients through deals. These deals are negotiated between two parties and outline terms such as data size, price, duration, and collateral. The deal-making process initially occurs *off-chain*. Once both parties agree to the terms, the deal is published *on-chain* for network-wide visibility and validation. ## Sectors Sectors are the fundamental units of provable storage where storage providers securely store client data and generate PoSt (Proof of Spacetime) for the Filecoin network. Sectors come in standard sizes, typically `32 GiB` or `64 GiB`, and have a set lifespan that providers can extend before it expires. [Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill_Page+URL=https://docs.filecoin.io/getting-started/what-is-filecoin/storage-model) # Storage market The storage market is the entry point where storage providers and clients negotiate and publish storage deals on-chain. ## Deal making The lifecycle of a deal within the storage market includes four distinct phases: * **Discovery**: The client identifies potential storage providers (SPs) and requests their prices. * **Negotiation**: After selecting an SP, both parties agree to the terms of the deal. * **Publishing**: The deal is published on-chain. * **Handoff**: The deal is added to a sector, where the SP can provide cryptographic proofs of data storage. ## Filecoin Plus Filecoin Plus aims to maximize useful storage on the Filecoin network by incentivizing the storage of meaningful and valuable data. It offers verified clients low-cost or free storage through a system called datacap, a storage quota that boosts incentives for storage providers. Verified clients use datacap allocated by community-selected allocators to store data on the network. In exchange for storing verified deals, storage providers receive a 10x boost in storage power, which increases their block rewards as an incentive. * **Datacap**: A token allocated to verified clients to spend on storage deals, offering a 10x quality multiplier for deals. * **Allocators**: Community-selected entities responsible for verifying storage clients and allocating datacap tokens. * **Verified Clients**: Active participants with datacap allocations for their data storage needs. ## Storage on-ramps To simplify data storage on the Filecoin network, several tools offer streamlined integration of Filecoin and IPFS storage for applications or smart contracts. These storage helpers provide libraries that abstract the Filecoin deal-making process into simple API calls. They also store data on IPFS for efficient and fast content retrieval. Available storage helpers include: * [Filecoin Onchain Cloud](/build-on-filecoin/filecoin-onchain-cloud): A programmable, on-chain storage platform with verifiable storage proofs (PDP) and automatic payments (Filecoin Pay), accessed through the Synapse SDK. * [Filecoin Pin](/build-on-filecoin/cookbook/filecoin-pin/getting-started): A CLI and API path for pinning IPFS-compatible content to Filecoin-backed storage with Filecoin Pay. * [fil.one](https://fil.one/): S3-compatible object storage backed by Filecoin, with flat per-terabyte pricing and no egress fees. * [lighthouse.storage](https://www.lighthouse.storage/): An SDK for builders, providing tools for storing data from dApps. * [Akave](https://www.akave.ai/): A modular L2 solution for decentralized data management, combining Filecoin storage with encryption and easy-to-use interfaces. * [Pinata](https://pinata.cloud/): An IPFS pinning service for storing and serving files, media, and app data over IPFS. * [Curio](https://curiostorage.org/): A next-gen platform within the Filecoin ecosystem, streamlining storage provider operations. * [boost.filecoin.io](https://boost.filecoin.io/): A tool for storage providers to manage data onboarding and retrieval on the Filecoin network
프로젝트로 돌아가기