dfinity-intro1.md

DFINITY 课程作业讲解 - Mulander

第1课 - 使⽤ SDK 搭建简易⽹站

课程回顾

1.安装SDK

安装指引

# 如果下载中途提示是否继续下载，请输入y即可
sh -ci "$(curl -fsSL https://smartcontracts.org/install.sh)"

# 将 dfx 添加至bin目录，方便快速引用
export PATH=/home/$USER$/bin:$PATH

2.第一个实例：部署静态网站

领取 Cycle | 官方水龙头 ：Cycle Faucet | currently getting reworked

#1.确保已成功安装dfx
dfx --version
#2.查看自己的 principal
dfx identity get-principal
#2.P.S 如果已拥有账号，欲导入已有的principal
# <name> 账号昵名， <pem path> 私钥文件地址
dfx identiy imoprt <name> <pem path>
#3.通过dfx以当前身份调用主网的水龙头服务
# 格式：dfx cansiter --network=ic call 服务容器ID 函数名 传入参数
dfx canister --network=ic \ call fg7gi-vyaaa-aaaal-qadca-cai redeem '("xxxxx-yyyyy-zzzzz")'
#3. Return 钱包容器ID WALLET_CANISTER_ID
# !!!此钱包容器ID需自己备份保存!!!
(principal "*****-*****-*****-*****-cai")
#4. 绑定钱包
dfx identity --network=ic set-wallet WALLET_CANISTER_ID
#5. 查看余额
dfx wallet --network=ic balance

部署应用

# 1.使用脚手架快速生成一个简单的项目模板
dfx new project_name
# 2.确认dfx.json文件
cat ./dfx.json
# 2.部署主网
dfx deploy --network=ic --with-cycles=400000000000
# 3.查看部署成功的canisterId
# 打包文件在./dfx/
cat ./canister_ids.json
# 4.访问部署在 IC ⽹络的项⽬
# 将以下命令中<canister_id>替换成⾃⼰应⽤的前端项目canister_id 
https://<canister_id>.ic0.app

3.ICP技术优势

• 48字节 ChainKey 公钥验证，
• 不让⽤户安装任何插件 毫秒级查询响应，2秒交易最终确认；
• 简化了区块链 DAPP 架构；
• Canister，轻量级容器封装代码和数据；
• JS Agent 库提供底层⽀持；
• 对安全性的需求：数据安全，计算可信 ------> 去中⼼化

作业点评

第1课共有 4 道题⽬

(1 组 17 位学员，有 12 位提交了作业，满分的有 6 位。)

1. 安装并使用 SDK 在本机搭建一个简易网站 。（2 分，请提交源代码链接）
2. 使用优惠码领取 cycles 钱包（2 分，请提交领取成功的 wallet canister ID）
3. 将网站部署到 ic0.app 主网。 （3 分，请提交部署的网址链接）
4. 思考题：假如开发团队不再维护代码了，用户该怎么办？（3 分，请以文字描述，本题为开放题）

思考题回答：

1. 根源/诱因：团队跑路、容器Cycle耗尽。（1分）
2. 解决方案（2-3分）

• 问题导向 ｜ 问题已发生如何解决
  • 如果未冻结，可由用户或第三方对其容器捐赠cycle解冻
  • 开源代码重新部署｜存在信用背书和数据恢复问题
• 目标导向 ｜ 从将来出发如何规划
  • 代码中预留cycle接收和查询的接口，定期维护与告警
  • 集成合理的权限管理机制或DAO，使得canister的所有权可流转
• 社区提议(bonus) 翻译原文
  • 系统事件将为canister提供一个通用机制，以对生命周期事件做出反应，如耗尽cycle
  • 备份/恢复将有助于将数据保存在canister之外，以便在数据因任何原因丢失的情况下能够恢复。
  • Canister WHOIS和dfx top将为社区提供基础设施，以建立更好的canister管理仪表盘。
  • 周期预测模型将使我们能够更好地预测周期使用情况和计费成本。

常见问题分析

• dfx 下载安装失败： 去官方发行版本列表下载手动安装; 使用梯子代理; 修改host
• github 源码文件不全或提交了多余的文件：请确认.gitignore合理配置
• 提交了错误的主网应用地址：请区分本地地址与主网地址
• 多个钱包时应用部署或钱包设置异常：请确认使用了正确的钱包地址
• 本地运行失败：使用dfx start --clean清除缓存或者已存在重复的进程需要kill

补充资料

dfx常用命令

# get principal
dfx identity get-principal
# set wallet
dfx identity --network=ic set-wallet CANISTER_ID
# get wallet
dfx identity --network=ic get-wallet
# check balance
dfx wallet --network=ic balance

# start node
dfx start
# in backgaround
dfx start --background
# clean cahce
dfx start --clean

#build with check
dfx build --check

#local
dfx deploy
#mainnet
dfx deploy --network=ic --with-cycles=400000000000
#ReInstall
dfx deploy --network=ic -m reinstall <canister>

#Stop one
dfx canister --network=ic stop <canister>
#Stop all
dfx canister --network=ic stop --all

#Delete one
dfx canister --network=ic delete <canister>
#Delete all
dfx canister --network=ic delete --all

#Call
dfx canister call mysite fibonaci '(10)'
dfx canister --network=ic  call 4rl4k-uiaaa-aaaal-qaknq-cai get

# Deposit cycles 
# *Only the controllers of the canister
# Deposit cycles one
dfx canister deposit-cycles <amount> <canister>
# Deposit cycles for all by dfx.json
dfx canister deposit-cycles <amount> --all

#Cache
dfx cache show
#Path
export PATH=$(dfx cache show):$PATH

#Compiler Runtime
moc
#Compiler file
moc --package base $(dfx cache show)/base -r src/mysite/main.mo

i.e. Check Cycles Balance

import ExperimentalCycles "mo:base/ExperimentalCycles";

actor {
    public query func getCycles() : async Nat {

      Cycles.balance();
    };
};

引用链接：

• IC-Official
  • Hello 10min
  • Cycle Faucet | currently getting reworked
  • Deploy
  • DFX Commond
  • dfx.json
• Candid UI
• Motoko Playground
• Create-IC-APP|Vue
• Cycle Donate | tipjar
• IC-Bookmarks