You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/intro.md
+3-3
Original file line number
Diff line number
Diff line change
@@ -5,19 +5,19 @@ sidebar_position: 1
5
5
6
6
# Stacks Docs
7
7
8
-
**Stacks brings smart contract functionality to Bitcoin, without modifying Bitcoin itself.**
8
+
**Stacks is Bitcoin L2 that brings smart contract functionality to Bitcoin, without modifying Bitcoin itself.**
9
9
10
10
These docs serve as:
11
11
12
-
1. An introduction to Stacks (what it is, why you should care, how to build on it),
12
+
1. An introduction to Stacks (what it is, why you should care, how to build Bitcoin apps with it),
13
13
2. A reference guide to various aspects of the Stacks ecosystem
14
14
3. A collection of tutorials and code samples to help you learn and build
15
15
16
16
If you see something you think you might want to contribute, [please do so](/docs/contribute)! We are always looking for good contributions from the community.
17
17
18
18
## Tutorials
19
19
20
-
Looking to understand how to build full-stack dapps on Stacks? These tutorials will give you a solid introduction. At the moment we have an intro tutorial and a collection of community-created tutorials, with a comprehensive deep-dive tutorial covering BTC integration on the way.
20
+
Looking to understand how to build full-stack Bitcoin dapps with Stacks? These tutorials will give you a solid introduction. At the moment we have an intro tutorial and a collection of community-created tutorials focusing on Stacks and Clarity specifically, with a comprehensive deep-dive tutorial series covering Bitcoin-first development on the way.
Copy file name to clipboardExpand all lines: docs/stacks-academy/what-is-stacks.md
+14-27
Original file line number
Diff line number
Diff line change
@@ -10,28 +10,11 @@ We can get an idea of the goal and ethos behind Stacks by looking at [how Satosh
10
10
11
11
> "...to be a completely separate network and separate block chain, yet share CPU power with Bitcoin...all networks in the world would share combined CPU power, increasing the total strength."
12
12
13
-
This is major theme in the design decisions for Stacks.
14
-
15
-
There's a lot of jargon, possible assumptions, controversy, and cool technology wrapped up in those statements. So let's get started by getting a 30,000 foot view of what exactly Stacks is.
16
-
17
-
## Stacks Explained in (Slightly Less Than) 10 Minutes
This is major theme in the design decisions for Stacks. A bit of a contradiction in the Bitcoin world, the Stacks network is a Bitcoin L2, but it does have its own token.
14
+
15
+
This is an intentional and critical design decision primarily for the purpose of maintaining decentralization, rather than needing to rely on a federation.
16
+
17
+
If that's confusing or you are skeptical, that's understandable, we'll be diving deeper into these ideas as we go through Stacks Academy.
35
18
36
19
## Stacks and the Purpose of Blockchain Technology
37
20
@@ -51,19 +34,23 @@ Bitcoin is the most decentralized, most secure, and most immutable blockchain ne
51
34
52
35
Bitcoin is very slow compared to other networks. Bitcoin only has a new block written once every 10 minutes or so, making its throughput negligible compared to networks designed for speed like Solana.
53
36
54
-
Bitcoin is also boring. Ethereum came along after Bitcoin and sought to do the same thing for software that Bitcoin did for money. Ethereum's goal is to be a decentralized supercomputer of sorts, serving as a global compute environment for smart contracts (code that is written to a blockchain).
37
+
Bitcoin is also "boring". Ethereum came along after Bitcoin and sought to do the same thing for software that Bitcoin did for money. Ethereum's goal is to be a decentralized supercomputer of sorts, serving as a global compute environment for smart contracts (code that is written to a blockchain).
55
38
56
39
Bitcoin is also not scalable. Because every new block must propagate to every node on the network, Bitcoin can only run as fast as the slowest node in the network. Now we are seeing the rise of modular blockchain networks like Cosmos that are designed to make it easy for people to spin up their own blockchain networks.
57
40
58
-
While most new blockchain protocols popping up these days see these properties as negatives and seek to eliminate them, Stacks takes a different approach.
41
+
While most new blockchain protocols popping up these days see these properties as negatives and seek to eliminate them, the Stacks community sees things differently.
59
42
60
43
## The Stacks Way
61
44
62
45
Stacks takes a pyramid approach, where you have the foundational settlement layer at the bottom (Bitcoin), and then a layer on top of that to add smart contracts and programmability (Stacks), and then layers on top of that for scalability and speed (Hiro's Subnets).
63
46
64
-
By taking this approach, we are able to have all of the same functionality as chains like Ethereum without all of the drawbacks of having a massively complex chain.
47
+
Additionally, there are other layers on top of Bitcoin that serve different purpose and have their own mechanisms and philosophies like Lightning, RSK, and Liquid.
48
+
49
+
By taking this layered approach, we are able to have all of the same functionality as chains like Ethereum without all of the drawbacks of having a massively complex chain.
50
+
51
+
So Stacks is a Bitcoin layer 2 with some unique properties, like having its own token, that acts as an incentive mechanism to maintain a historical ledger of all of its transactions and operate with its own security budget.
65
52
66
-
So Stacks is a Bitcoin layer with some unique properties, like having its own token, that allow it to maintain a historical ledger of all of its transactions and operate with its own security budget.
53
+
The only alternative to this model is a federated model like what Liquid uses. Stacks' design decisions operate under the idea that decentralization is more important than rejecting altcoins.
67
54
68
55
This is one of the things that separates Stacks from other Bitcoin layers like Lightning.
69
56
@@ -79,7 +66,7 @@ This is an important property when we are talking about building blockchains tha
79
66
80
67
_Sounds like a sidechain_.
81
68
82
-
Nope. We'll get into the technical details of how this works in the next section, but because Stacks records its entire history to Bitcoin, it is at least as hard to re-org the Stacks chain as it is Bitcoin. This is a key differentiator from side chains, which do not have their history recorded to their primary chain.
69
+
Not quite. We'll get into the technical details of how this works in the next section, but because Stacks records its entire history to Bitcoin, it is at least as hard to re-org the Stacks chain as it is Bitcoin. This is a key differentiator from side chains, which do not have their history recorded to their primary chain.
83
70
84
71
Second, Stacks has its own token, it does not represent pegged Bitcoin. While this may ruffle some feathers among some people in the Bitcoin community, it has several advantages.
0 commit comments