Glossary
Last updated
Was this helpful?
Last updated
Was this helpful?
In the Filecoin network, an address is a unique cryptographic value that serves to publicly identify a user. This value, a public key, is paired with a corresponding private key. The mathematical relationship between the two keys is such that access to the private key allows the creation of a signature that can be verified with the public key. Filecoin specifically employs the Boneh–Lynn–Shacham (BLS) signature scheme for this purpose.
In a blockchain, a block is the fundamental unit of record. Each block is cryptographically linked to one or more previous blocks. Blocks typically contain relating changes to some state (for example, financial records) tracked by the blockchain.
Fundamentally, a blockchain is a system of record in which new records, or are cryptographically linked to preceding records. This construction is a foundational component of secure, verifiable, and distributed transaction ledgers.
The height of a corresponds to the number of elapsed before the block was added to the blockchain. The height of the Filecoin is defined to be the maximum height of any block in the blockchain.
If a storage miner doesn't find any available deal proposals appealing, they can alternatively make a capacity commitment, filling a with arbitrary data, rather than with client data. Maintaining this sector allows the storage miner to provably demonstrate that they are reserving space on behalf of the network.
In order to enter into a , a is required to provide as collateral, to be paid out as compensation to a client in the event that the miner fails to uphold their storage commitment.
Two participants in the Filecoin network can enter into a deal in which one party contracts the services of the other. The Filecoin specification currently details storage deals (in which one party agrees to store data for the other for a specified length of time) and retrieval deals (in which one party agrees to transmit specified data to the other).
FIL is the name of the Filecoin unit of currency; it is alternatively denoted by the Unicode symbol for an integral with a double stroke (⨎).
The term Filecoin is used generically to refer to the Filecoin project, protocol, and network.
A portmanteau of "main" and "network, mainnet is a term used to refer to the predominant public-facing network of the Filecoin project and community. The mainnet embodies an expectation of widespread adoption and permanence; changes to its protocol are subject to the adoption of the network participants.
If used as a proper noun, capitalize the term: "I am mining on Mainnet."
Many blockchain networks are underpinned by the notion that participants supply something of value to the blockchain - a contribution that is hard to fake, but which, if actually made, can be trivially verified. Blockchains based in this approach are often said to require "Proof-of-X", where X is the valued contribution. The Filecoin blockchain values contributions of storage capacity; it is predicated upon a novel Proof-of-Storage construction, distinguishing it from other blockchains that, as is most often the case, require a contribution of computing power.
As a term, Proof-of-Storage refers to the design elements of the Filecoin protocol that allow one to guarantee (to some very high tolerance) that participants that claim to be contributing a given amount of storage are indeed fulfilling that pledge. In fact, Filecoin's Proof-of-Storage construction provides for a much stronger claim, allowing one to efficiently verify that a participant is storing a particular piece of data, without requiring that one have a copy of the file itself.
Note: "proof" here is used in an informal sense - typically, these proofs take the form of a probabilistic argument, rather than a concrete proof; that is, it might technically be possible to convince other participants that one is making a contribution one is not, but the possibility is so vanishingly slight as to border on impossibility.
Storage miners store data on behalf of the Filecoin network in fixed-size blocks of data called sectors.
An argument of knowledge is a construction by which one party, called the prover, can convince another, the verifier, that the prover has access to some piece of information. There are several possible constraints on such constructions:
A non-interactive argument of knowledge has the requirement that just a single message, sent from the prover to the verifier, should serve as a sufficient argument.
A zero-knowledge argument of knowledge has the requirement that the verifier should not need access to the knowledge the prover has access to in order to verify the prover's claim.
A succinct argument of knowledge is one that can be "quickly" verified, and which is "small", for appropriate definitions of both of those terms.
Note: if used as a proper noun, capitalize the term. For example, "I am mining on Testnet."
Each tipset is assigned a weight corresponding to the amount of storage the network is provided per the commitments encoded in the tipset's blocks. The consensus protocol of the network directs nodes to build on top of the heaviest chain.
Storage miners who fail to do this in the necessary window will forfeit their opportunity to mine a block, but will not otherwise incur penalties for their failure to do so.
Every , a small subset of Filecoin are elected to mine a new for the Filecoin blockchain. A miner's probability of being elected is roughly proportional to the share of the Filecoin network's total storage capacity that they contribute.
Time in the Filecoin blockchain is discretized into epochs that are currently thirty seconds in length. Every epoch, a subset of storage miners are elected to each add a new block to the Filecoin blockchain via .
A faucet is a service that provides free . Typically, faucets are run for the benefit of new users in a network, providing them with the necessary seed capital to begin making transactions.
When a fails to complete for a given sector, the Filecoin network registers a fault for that sector, and the miner is . If a storage miner does not resolve the fault quickly, the network assumes they have abandoned their commitment.
Finality refers to the immutability of messages and state recorded to the Filecoin blockchain. As new blocks are added to the blockchain, it becomes more and more difficult for older blocks to be altered, until they become effectively impossible to modify. The finality period is the amount of time that must elapse before a block is considered completely immutable. In the current , this is configured as 900 .
Gas is a property of a , corresponding to the resources involved in including that message in a given . For each message included in a block, the block's creator extracts a fee from the message's sender; this fee is proportional to the message's gas.
The term message is used to refer to data stored as part of a . A block can contain several messages.
The Filecoin project uses the term miner to refer to participants in the network who provide a service of value to a client. At present, the Filecoin specification recognizes two miner types: and .
Storage capacity that a miner has promised to reserve for the Filecoin network via is termed pledged storage.
Proof-of-Replication is a procedure by which a can prove to the Filecoin network that they have created a unique copy of some piece of data on the network's behalf.
Proof-of-Spacetime is a procedure by which a can prove to the Filecoin network they continue to store a unique copy of some data on behalf of the network. Proof-of-Spacetime manifests in two distinct varieties in the present Filecoin specification: and .
The storage power a earns from a storage deal offered by a will be augmented by a multiplier. Power totals that take into account this multiplier are termed quality adjusted.
A retrieval miner is a Filecoin participant that enters retrieval with clients, agreeing to supply a client with a particular file in exchange for . Note that unlike , retrieval miners are not additionally rewarded with the ability to add blocks to the Filecoin blockchain; their only reward is the fee they extract from the client.
Sealing is one of the fundamental building blocks of the Filecoin protocol. It is a computation-intensive process performed over a that results in a unique representation of the sector. The properties of this new representation are essential to the and the procedures.
When a is registered for a , the Filecoin network will slash the that is supposed to be storing the sector; that is, it will assess penalties to the miner (to be paid out of the fronted by the miner) for their failure to uphold their pledge of storage. When slashing takes place, the power a miner earns for the associated sector is subtracted from the miner's total power for the purposes of .
A storage miner is a Filecoin participant that stores data on behalf of the network. Storage miners are rewarded for this service through payments by clients that contract their services, as well as by periodic authorization to extend the Filecoin with of their own creation. When they create a block, storage miners are rewarded with newly minted , as well as the transaction fees they can levy on other participants seeking to include in the block.
A storage power is a value roughly proportional to the amount of storage capacity they make available on behalf of the network via or . Storage power is used to select storage miners for rewards in proportion to their contributions to the total network storage capacity.
A zero-knowledge, succinct non-interactive argument of knowledge (zk-SNARK) embodies all of these properties. Filecoin utilizes these constructions to enable its distributed network to efficiently verify that are storing files they pledged to store, without requiring the verifiers to maintain copies of these files themselves.
A portmanteau of "test" and "network, testnet is a term used to refer to one of the .
A is a set of that each have the same and parent tipset; the Filecoin is a chain of tipsets, rather than a chain of blocks.
By basing its blockchain on tipsets, Filecoin can allow multiple to create blocks in the same , increasing network throughput. By construction, this also provides network security: a node that attempts to intentionally prevent the valid blocks of a second node from making it onto the canonical chain runs up against the consensus preference for heavier chains.
To further incentivize the storage of "useful" data over simple , have the additional opportunity to compete for special offered by . Such clients are certified with respect to their intent to offer deals involving the storage of meaningful data, and the power a storage miner earns for these deals is augmented by a multiplier.
Window Proof-of-Spacetime (WindowPoSt) is the mechanism by which the commitments made by are audited. It sees each 24-hour period broken down into a series of windows. Correspondingly, each storage miner's set of pledged is partitioned into subsets, one subset for each window. Within a given window, each storage miner must submit a for each sector in their respective subset. This requires ready access to each of the challenged sectors, and will result in a proof published to the Filecoin as a in a . In this way, every sector of is audited at least once in any 24-hour period, and a permanent, verifiable, and public record attesting to each storage miner's continued commitment is kept.
The Filecoin network expects constant availability of stored data. Failing to submit WindowPoSt for a sector will result in a , and the storage miner supplying the sector will be .
Winning Proof-of-Spacetime (WinningPoSt) is the mechanism by which are rewarded for their contributions to the Filecoin network. At the beginning of each , a small number of storage miners are to each mine a new . As a requirement for doing so, each miner is tasked with submitting a compressed for a specified . Each elected miner who successfully creates a block is granted , as well as the opportunity to charge other Filecoin participants fees to include in the block.