Skip to content

Commit 8e6bc1a

Browse files
authored
Remove todos by linking to related specs
1 parent c048c6f commit 8e6bc1a

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

ARCHITECTURE.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ privateKey, publicKey := keygen()
5656
nodeID := multihash(publicKey)
5757
```
5858

59-
TODO: constraints on keygen.
59+
See more in the [IPFS keystore spec](https://github.com/ipfs/specs/blob/master/KEYSTORE.md).
6060

6161
## 2.1 multihash and upgradeable hashing
6262

@@ -124,7 +124,7 @@ The Block Exchange is an interface that is satisfied by various kinds of impleme
124124

125125
## 3.4. Merkledag -- making sense of data
126126

127-
[As discussed above](#IPFS-and-the-Merkle-DAG), the IPFS **merkledag** is the datastructure at the heart of IPFS. It is an [acyclic directed graph](http://en.wikipedia.org/wiki/Directed_acyclic_graph) whose edges are hashes. Another name for it is the merkleweb.
127+
[As discussed above](#IPFS-and-the-Merkle-DAG), the IPFS **merkledag** (also known as IPLD - InterPlanetary Linked Data) is the datastructure at the heart of IPFS. It is an [acyclic directed graph](http://en.wikipedia.org/wiki/Directed_acyclic_graph) whose edges are hashes. Another name for it is the merkleweb.
128128

129129
The merkledag data structure is:
130130

@@ -147,7 +147,7 @@ The merkledag is the "thin waist" of authenticated datastructures. It is a minim
147147
- **bitcoin** and other blockchains
148148
- **unixfs**, a content-addressed unix filesystem
149149

150-
See more in the merkledag spec (TODO).
150+
See more in the [IPLD spec](https://github.com/ipld/specs/).
151151

152152
## 3.4.1 Merkledag Paths
153153

@@ -161,7 +161,7 @@ The merkledag is enough to resolve paths:
161161
- (b) Then look into the links of (a), find the hash for `test`, and resolve it
162162
- (c) Then look into the links of (b), find the hash for `foo`, and resolve it
163163

164-
See more in the path resolution spec (TODO).
164+
See more in the [path resolution spec](https://github.com/ipld/specs/blob/master/data-model-layer/paths.md).
165165

166166
![](img/ipfs-resolve/ipfs-resolve.gif)
167167

@@ -175,15 +175,15 @@ The IPFS **naming** layer -- or IPNS -- handles the creation of:
175175

176176
IPNS is based on [SFS](http://en.wikipedia.org/wiki/Self-certifying_File_System). It is a PKI namespace -- a name is simply the hash of a public key. Whoever controls the private key controls the name. Records are signed by the private key and distributed anywhere (in IPFS, via the routing system). This is an egalitarian way to assign mutable names in the internet at large, without any centralization whatsoever, or certificate authorities.
177177

178-
See more in the naming spec (TODO).
178+
See more in the [IPNS spec](https://github.com/ipfs/specs/blob/master/IPNS.md).
179179

180180
# 4. Applications and Datastructures -- on top of IPFS
181181

182182
The stack described so far is enough to represent arbitrary datastructures and replicate them across the internet. It is also enough to build and deploy decentralized websites.
183183

184184
Applications and datastructures on top of IPFS are represented as merkledags. Users can create arbitrary datastructures that extend the merkledag and deploy them to the rest of the world using any of the tools that understand IPFS.
185185

186-
See more in the datastructures and applications specs (TODO).
186+
See more in the [IPLD datastructures specs](https://github.com/ipld/specs/tree/master/data-structures).
187187

188188
## 4.1 unixfs -- representing traditional files
189189

@@ -192,7 +192,7 @@ The unix filesystem abstractions -- files and directories -- are the main way pe
192192
- whether the object represents a file or directory.
193193
- total sizes, minus indexing overhead
194194

195-
See more in the unixfs spec (TODO).
195+
See more in the [unixfs spec](https://github.com/ipfs/specs/blob/master/UNIXFS.md).
196196

197197
## 5. Lifetime of fetching an object.
198198

0 commit comments

Comments
 (0)