编写Web3项目白皮书的技巧
当规范想要了解加密货币并要求业内人士提供起点时，OG 通常会指导他们阅读比特币白皮书。不幸的是，这让大多数读者感到困惑和劝阻，因为比特币白皮书假定了解某些技术概念（例如默克尔树），并且对于普通读者来说是相当难以理解的。然而，比特币白皮书可以说是有史以来最具影响力的白皮书之一。这就引出了一个问题，什么元素构成了一份好的白皮书，它们是为谁而写的？
在这里，我们将讨论白皮书的目的，并介绍有效设计的九个原则。
白皮书重要吗？
白皮书在加密货币生态系统中发挥着关键作用。在专注于 DYOR（自己研究）的文化中，白皮书为感兴趣的潜在用户提供了最佳可扩展的异步媒介，以了解协议的愿景和设计。通过引人注目的散文传达明确的使命也可以吸引具有意识形态思想的全新社区。
白皮书还可用于吸引其他核心生态系统参与者
- 吸引投资者——白皮书为个人和机构投资者提供了一种深入评估协议架构、权衡、增长潜力和创始人清晰沟通能力的方法。
- 吸引贡献者——许多工程师都是任务驱动的，他们希望从事最具影响力的项目，这也可能为他们带来经济回报——因为白皮书通常是在协议发布之前编写的，许多工程师阅读白皮书并有动力贡献 PR 或加入团队。
重要的是要注意，写得好的白皮书可以激发社区的活力并建立信心，但它们并不能保证未来的成功——一份好的白皮书并不一定意味着一个团队能够成功地建立和启动，同样地，具有弱（或没有）白皮书可以构建非常成功的协议。
在这里，我们将回顾撰写引人注目的白皮书的九个建议——注意，这包括我基于审查数百份白皮书的个人偏见。但是，我确实根据证据提出了我的建议，并强调了多份白皮书中的示例。以下是参考白皮书的链接：比特币、（原始）以太坊、Uniswap V3、tbDEX、DYDX、Terra、Polkadot、STEPN和Photo Finish。
此外，作为创始人，以对你的协议最有效的格式和风格编写白皮书很重要；加密货币社区还没有围绕白皮书“必须”包含或看起来像什么——一些协议使用期刊文章格式，而一些使用 Gitbook——一些协议更新他们的白皮书，而一些没有——一些非常技术性，而另一些则不是. 最终，最好做你认为有效的事情来激励和教育你的核心受众。
撰写有用白皮书的九个技巧
#1 了解你的听众
与产品经理为他们的目标用户设计产品类似，重要的是要知道你的协议的目标受众是谁，并主要为这个社区定制你的白皮书。例如，Uniswap V3 白皮书包含详细的数学计算，因为他们的目标是教育并最终说服他们最重要的目标用户——交易员和做市商——将流动性从 V2 转移到 V3。比特币白皮书在没有介绍技术基础的情况下解释了默克尔树和 SHA256 等加密货币标准的使用，主要是因为在撰写本文时，他们的主要社区是构建网络和生态系统所需的开发人员和加密货币学家。不同但合适，STEPN 是一个从根本上更简单的协议，面向希望健身的日常用户，
请注意，如果你尝试为太多社区服务，你的论文可能会变得臃肿或缺乏，并且实际上会失去最重要的读者的兴趣或可信度。
#2 上下文 -> 问题 -> 解决方案
白皮书简介的目标是为你的解决方案为何重要奠定基础。为此，你应该在介绍你的解决方案之前提供有关当前环境的最少但必要的关键上下文以及现有协议的显着挑战和限制。比特币白皮书巧妙地做到了这一点——第一句话为今天[通过金融机构]的支付方式奠定了基础，接着强调了当前系统的三个弱点[没有不可逆的交易、成本、降低隐私]，最后是介绍了比特币并扩展了信任加密货币学而不是交易对手的概念。在由两段组成的引言结尾处，用户了解了当今存在的痛点以及去信任支付轨道的好处。
解释痛点深度的事实和数据使读者能够产生同理心，并成为吸引用户、贡献者和投资者的灯塔。例如，tbDEX 白皮书使用统计数据突出显示可以通过基于区块链的解决方案（数十亿）实现金融能力的大量额外用户。
然而，平衡适当数量的上下文和问题概述是很重要的。对我来说，以太坊白皮书对历史背景的索引过高，并且没有足够早地概述痛点/挑战。白皮书直到第 12 页才提供当前区块链缺陷的摘要，并且除了第 1 页上的一句话外，直到第 13 页才介绍以太坊。
总之，早期的读者需要适当的上下文来理解你的解决方案的重要性，否则不清楚为什么需要你的解决方案。
#3 保持谦虚
加密货币具有很强的工程意识，工程师通常不喜欢推销员或混蛋。工程师更关心的是展示我还是推销我。有史以来最有影响力的论文措辞谦逊——比特币、以太坊、DYDX 等并没有声称自己是“最好的”协议，也没有贬低他们的前辈，因为他们事实上概述了他们设计的好处。白皮书根本不是营销文档，任何营销尝试（尤其是吹嘘）都会劝阻最真实的社区。此外，谦虚还有一个额外的好处，那就是不会吸引那些可能正在寻找快速暴涨的人。
#4 创建类比
类比使人类能够更快地学习并更好地可视化抽象概念。特别是在介绍复杂的主题时，引入用户熟悉的概念作为垫脚石是非常有效的。例如，在 Polkadot 白皮书中，Gavin Wood 博士概述了 Polkadot 将接受 RFC（评测请求），并将类似的概念用于广泛的编程语言——Python 增强提案——以确保开发人员了解他们可以参与的类型期待协议的发展。此外，为了传达新的比特币是通过消耗工作获得的，而不是由中央机构发行的这一点，比特币白皮书将开采比特币与金矿工开采黄金进入流通进行了比较。
#5 使用示例
除了类比之外，示例还可以帮助用户快速理解概念。当向读者展示复杂的数学概念时尤其如此——与 Alice 和 Bob 的简单类比可以帮助说明关键概念。例如，在以太坊白皮书的第 5 页，Vitalik 介绍了“状态转换函数”的概念。为了阐明这个想法，在下一句中，Vitalik 使用了一个示例，将“状态”与银行资产负债表和“站点转换函数”进行比较，将 X 美元从 A 转移到 B，其中包括账户 A 的减少以及账户 B 的增加。该示例立即清楚地表明状态转换函数包括更新资产负债表（分类帐）所需的所有信息。
另一个有效的例子和图形的使用是 Uniswap V3 白皮书。在介绍新的中心化流动性功能时，Hayden 解释说，流动性提供者可以自由地在“价格空间”上创建许多头寸，并且中心化流动性使 LP 能够近似任何“流动性分布”。为确保读者跟进，他介绍了流动性分布在不同价格范围内的三个图示示例，很快就会清楚流动性可以中心化在某些价格范围内。图形示例为用户提供了散文和数学描述的物理参考。
#6 深度上的完整性
白皮书应该是完整的，因为它涵盖了协议的关键架构、流程和行为。然而，完整性不同于深度。白皮书应旨在涵盖核心要素，以便读者可以评估协议，但应谨慎这样做，以牺牲可读性为代价。对于技术协议，这通常意味着解释架构和系统设计，而不是深入研究具体的功能或代码片段。例如，DYDX 白皮书在散文中概述了打开和关闭期权头寸的步骤，但不包括代码片段或讨论特定的功能或方法。对于 DeFi 协议，白皮书应该包括关键的控制方程，但也许可以将推导放到附录中。
了解深度有一些好处。首先，即使方法或基础网络（在 DYDX 的情况下）发生变化，你的白皮书也会更加持久。其次，它使文档保持可读性和可访问性。最后，它在早期揭示了不太具体的潜在竞争信息。如有疑问，请将信息推送到附录或保留并在单独的文档中发布；黄皮书概述了更深层次的技术元素，同样，如果需要，你可以随时发布单独的用户指南。
#7 探索风险和失败模式
在了解了你的协议是如何工作的之后，下一个问题自然是，“会出什么问题？” 在我看来，强有力的白皮书包括风险分析部分和/或故障模式分析。DYDX 和 tbDEX 的白皮书包括特定的风险部分，而其他协议则自始至终讨论风险。
一般来说，我更喜欢协议的白皮书，尤其是具有复杂实现的 DeFi 协议，包括“故障模式”或“压力测试”，因为它可以帮助我建立对设计者对底层动态有深刻理解的信心，因此可以建立针对灾难性情景的保护措施。作为投资者，如果论文没有讨论这个问题，这通常是我的第一个尽职调查问题之一。
包含稳健风险评估的作者在社区内建立了深厚的可信度和可信度，这样做有助于抢占基线问题，否则可能会去中心化注意力。包含风险和/或故障模式（以及缓解措施）使产品看起来更强大。然而，这可能是一个陷阱并建立错误的信心，尤其是在使用复杂的数学或K线走势图时。例如，Terra 白皮书包括“广泛的模拟”和K线走势图，显示了区块链在“重大压力”下的表现。也就是说，也许通过模拟进行的协议校准实际上确实帮助协议维持了它所做的时间长度——直到它没有。
#8 包括代币经济学
代币经济学在中心化和去中心化协议的最初采用和发展中发挥着至关重要的作用。理想情况下，你的代币经济学已经足够成熟，可以在基本层面（例如代币的用途）包含在白皮书中，即使具体的发行率和初始分配将在以后最终确定。在讨论代币经济学时，详尽无遗很重要，涵盖你的用户和投资者需要了解的最重要领域；初始分配、归属时间表、代币的效用和系统中的特定接收器/源。特别是像 Photo Finish 这样的游戏，通常包含详细的流程图，有效地概述了代币的基本机制和潜在用途。
#9 证券注意事项
完全免责声明——我不是律师，这不构成法律建议。
Howie 测试是监管机构和交易所用于证券分析的关键测试。它的目的是确定投资合约是否存在并且由四个语句组成；如果所有四个都为真，那么该资产可以被视为投资合约，因此属于 SEC 的监管管辖范围：
豪伊·泰斯特
- 金钱的投资
- 在一个普通的企业
- 带着对利润的期望
- 源于他人的努力
监管机构和交易所使用项目文件进行证券分析。我看到有两个主要领域的白皮书被认为是有力的证据。第一个是“预期利润”条款。在你的论文中，强烈建议不要写代币的预期价格升值。相反，白皮书应该关注代币本身——它在协议中的用途、它允许用户做什么、谁可以持有代币以及随着时间的推移流通的代币数量。
关注的第二个条款是“来自他人的努力”。真正的开源社区不是来自其他人（或单个企业）的努力，因为它是社区贡献和更新协议。然而，如果白皮书表明有一个中央团队在执行这项工作，那么人们可能会争辩说“源自他人的努力”条款得到了满足。相反，最好说明社区在协议中扮演的关键角色（例如验证者、治理、提交改进提案等），并在讨论核心团队的角色时深思熟虑。
