有段时间没写博客了，这段时间主要在做以下几件事情：

1、锻炼，周末的时候约了高中的好友去爬山。太久没锻炼了，累趴下了😅，还是要多练练。

2、无意间看到了雷公的视频，对我触动很大，不论是一级还是二级市场，都需要注重心态、技术。

3、趁着Gas低，交互了几个项目。

4、上班😄不上班没饭吃，肚子饿

正题

最开始有这个想法来源于：想把tg上订阅的Foresight News的bot消息转发到微信，这样有几个好处：

1、上班可以光明正大的看快讯

2、微信相当于聚合器，接收多路的消息。只要打开微信，就能收到我关注的消息，而不是群聊的垃圾信息。

…

但是目前还没搞定，tg的教程没怎么看明白。网上的教程基本都是微信转发到tg的，因为tg的服务器上文件是永久保存的，比化腾良心多了。

刚好推特上关注了@Whale Alert，这是一个产品，专门监控链上巨鲸大额转账的，刚好有开放的API（一定是特别的缘分），思路就是：申请免费api（虽然有限制，但是要啥自行车）—— 将返回的结果发送到企业微信（个人微信消息推送挺严格的，所以另辟蹊径，反正两者是可以绑定的）

我关注了很多大V，当看一个工具好不好用的时候，我通常会看共同关注，这些大v消息肯定是比我灵敏多了。

@Whale Alert API文档，其中免费账号的限制的内容。

https://docs.whale-alert.io/#introduction

直接上代码吧。都写注释了

先pip安装依赖，其他都自带了。就这两个

main.py

# -*- coding : utf-8 -*-
import os
import time
import ntplib
import json
import configparser
import requests
from send_msgs_to_wechat import SendWeiXinWork

config_path = os.path.join("properties.conf")
# 获取配置文件对象
cf = configparser.ConfigParser()
# 读取配置
cf.read(config_path, encoding='utf-8')

# 本地测试，开代理
os.environ["http_proxy"] = "http://127.0.0.1:10810"
os.environ["https_proxy"] = "http://127.0.0.1:10810"

# 创建发送消息对象
SendWeiXinWork = SendWeiXinWork()


# 从ntp服务器获取时间。防止运行的机器时间不对
def get_timestamp_from_ntp():
    ntp_url = 'pool.ntp.org'
    # noinspection PyBroadException
    try:
       ntp_client = ntplib.NTPClient()
       response_outside = ntp_client.request(ntp_url).tx_time
       start_timestamp = round(response_outside)
       return start_timestamp
   except Exception as exc:
       return round(time.time())


def main():
    # 发送警报的数组
    msgs = []

    # 时间阈值
    time_windows = 60

    # e.g https://api.whale-alert.io/v1/transactions?api_key='申请的key'&min_value=500000&start=1655707296

    # 警报的最小价值
    min_value = 5000000
    api_key = cf.get("Whale Alert", "api_key")
    base_url = 'https://api.whale-alert.io/v1/transactions?'
    base_scan_url = 'https://whale-alert.io/transaction'

    # 从ntp服务器获取时间。防止运行的机器时间不对
    # 减去窗口时间time_windows，相当于从前一分钟的时间作为开始时间
    start_timestamp = get_timestamp_from_ntp() - time_windows

    print(start_timestamp)

    # 拼接需要访问的url和参数。
    url = base_url + 'api_key' + '=' + api_key + '&' + 'min_value' + '=' + str(min_value) + '&' + 'start' + '=' + str(
        start_timestamp)

    response = requests.get(url)

    resp_dict = json.loads(response.text)

    #  判断状态是否是success并且数据条数要大于0
    if 'success'.__eq__(resp_dict['result']) and resp_dict['count'] > 0:
        transactions = resp_dict['transactions']
        if len(transactions) > 0:
            for transaction in transactions:
                # 在哪条链上
                blockchain = transaction['blockchain']

                # 代币名称
                symbol = transaction['symbol']

                # 交易类型
                transaction_type = transaction['transaction_type']

                # 交易hash
                transaction_hash = transaction['hash']

                # 发送地址
                from_address = transaction['from']['address']

                # 发送地址所属
                from_owner = transaction['from'].get('owner', 'Unknown')

                # 发送地址所属类型
                from_owner_type = transaction['from'].get('owner_type', 'Unknown')

                # 接收地址
                to_address = transaction['to']['address']

                # 接收地址所属
                to_owner = transaction['to'].get('owner', 'Unknown')

                # 接收地址所属类型
                to_owner_type = transaction['to'].get('owner_type', 'Unknown')

                # 交易时间戳
                transaction_timestamp = transaction['timestamp']
                transaction_date = time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(transaction_timestamp))

                # 币本位总数
                transaction_amount = str(transaction['amount']) + ' ' + symbol

                # 以usd计算价值
                transaction_amount_usd = str(transaction['amount_usd']) + ' ' + 'usd'

                # 转账次数
                transaction_count = transaction['transaction_count']

                msg = '区块链名称' + ': ' + blockchain + '\n' + '符号' + ': ' + symbol + '\n' + '交易类型' + ': ' + transaction_type + '\n' + '交易hash' + ': ' + transaction_hash + '\n' + '交易发起者地址' + ': ' + from_address + '\n' + '交易发起者地址所属' + ': ' + from_owner + '\n' + '交易发起者地址所属类型' + ': ' + from_owner_type + '\n' + '交易接收地址' + ': ' + to_address + '\n' + '交易接收地址所属' + ': ' + to_owner + '\n' + '交易接收地址所属类型' + ': ' + to_owner_type + '\n' + '交易发生时间' + ': ' + transaction_date + '\n' + '币本位总额' + ': ' + str(transaction_amount) + '\n' + '币本位价值usd总额' + ': ' + str(transaction_amount_usd) + '\n' + '交易转账次数' + ': ' + str(transaction_count) + '\n' + '区块链浏览器详情' + ': ' + base_scan_url + '/' + blockchain + '/' + transaction_hash
                msgs.append(msg)

    if len(msgs) > 0:
        # 发送到微信
        for msg in msgs:
            # 1 代表往企业总群发
            SendWeiXinWork.send_message("1", str(msg))
            print(msg)


if __name__ == '__main__':
    main()

注：代码里面当转账数额 > 500K 才会预警，要修改的话，改# 警报的最小价值 min_value = 5000000 这个参数。免费账号最小是500K。

send_msgs_to_wechat.py

# -*- coding : utf-8 -*-
# @DATE:2022/6/20 16:47
import requests, configparser, os

config_path = os.path.join("properties.conf")
# 获取配置文件对象
cf = configparser.ConfigParser()
# 读取配置
cf.read(config_path, encoding='utf-8')

# os.environ["http_proxy"] = "http://127.0.0.1:10810"
# os.environ["https_proxy"] = "http://127.0.0.1:10810"


class SendWeiXinWork():
    def __init__(self):
        self.CORP_ID = cf.get("Wei Xin", "CORP_ID")  # 企业号的标识
        self.SECRET = cf.get("Wei Xin", "SECRET")  # 管理组凭证密钥
        self.AGENT_ID = cf.get("Wei Xin", "AGENT_ID")  # 应用ID
        self.token = self.get_token()

    def get_token(self):
        url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken"
        data = {
            "corpid": self.CORP_ID,
            "corpsecret": self.SECRET
        }
        req = requests.get(url=url, params=data)
        res = req.json()
        if res["errmsg"] == "ok":
            return res["access_token"]
        else:
            return res

    def send_message(self, to_user, content):
        url = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=%s" % self.token
        data = {
            # "touser": to_user,  # 发送个人就填用户账号
            "toparty": to_user,  # 发送组内成员就填部门ID
            "msgtype": "text",
            "agentid": self.AGENT_ID,
            "text": {"content": content},
            "safe": "0"
        }

        req = requests.post(url=url, json=data)
        res = req.json()
        if res["errmsg"] == "ok":
            print("send message sucessed")
            return "send message sucessed"
        else:
            return res


# if __name__ == '__main__':
#     # 创建发送消息对象
#     SendWeiXinWork = SendWeiXinWork()
#     SendWeiXinWork.send_message("1", 'a' + '\n' + 'b')

properties.conf

这里面主要放申请的key什么的。

[Whale Alert]
api_key = '你申请的key'

[Wei Xin]
XXX = ''

注：关于企业微信的申请和发送消息。我就不写了，也是参考下面这位大佬的。

https://www.jb51.net/article/244955.htm

效果图

后面就是部署到服务器上，然后定时调度就行了。这个教程后面出，今天还有其他事情要忙。

需要提的是：

1、CentOS7 上默认安装的python版本是2.X的。本篇中用的是3.7，所以需要重新软链接到python3。切记不要把2.X删掉，要不然yum就用不了了

2、调度器用自带的crontab 就行。

uniswap v3集中流动性： 集中流动性意味着LP（流动性提供者）可以根据自己的意愿向任何价格范围/价格变动提供流动性，这导致流动性在价格变动中不平衡。

不同价格范围的流动性深度不同，深度不同导致获取的收益不同。

根据当前价格和目标价格范围，存在以下三种情况 （1）当前价格在目标价格区间 1、当前价格是目标价格范围的中心 当价格范围为[8，12]时，当前价格= 10。LP在相同价值的两个代币中提供流动性

2、当前价格不是目标价格范围的中心 LP仍然必须在两个代币中提供流动性，而每个代币的数量取决于当前价格和价格范围之间的距离

（2）当前价格 < 目标价格区间最小值 （3）当前价格 > 目标价格区间最大值 在情况2和3中，只需要或允许两个代币中的一个。 理解如何发现价格： x * y = k x和y代表两种代币的数量，k是常量 x相对于y的价格是 y / x，这意味着1单位X可以获得多少Y，反之亦然,y相对于x的价格是x/y。 为了X的价格上涨，y必须增加，x必须减少。

举例： 假设流LPs打算在高于当前价格x=10的区间——[15.625, 17.313]提供流动性。 （虽然没写，但是y的价格应该是1） 一个x = 1000 / 100 = 10个y

100(x) * 1000(y) = 100000(k)

当x价格上涨到15.625时，理解为：一个x可以换15.625个y了 80(x) * 1250(y) = 100000(k)

当x价格上涨到17.313时，理解为：一个x可以换17.313个y了 76(x) * 1315.789(y) = 100000(k)

X的价格进一步走高的唯一方法是进一步增加y和减少x

因此，要提供 [15.625, 17.313] 范围内的流动性，只需准备 80 - 76 = 4 个X。如果价格超过17.313，则 LP 的所有4个 X 都被交换为1315.789 - 1250 = 65.798 Y，然后 LP 与资金池不再有任何关系，因为他/她的流动性已经耗尽。

如果价格保持在该范围内: x的个数将在76~80之间摆动，y同理。只有当代币变得更有价值时，它才会被交换为价值较低的代币。

Alpha Vault： 自动为管理Uniswap V3上的流动性。集中流动性以获得更高的收益率，并定期被动再平衡以减少无常损失。 当两种资产变得不平衡且无法将其全部投入机枪池时，Vault 首先将两种资产的最大可用量投入机枪池中，然后再用有结余的一种资产投下另一个范围定单 。

被动再平衡

举例： 最初我们拥有的资产 50％ 为 ETH，另外 50％ 为 USDC。 一天后，随着 ETH 价格下跌，我们获得了更多的 ETH，而 USDC 减少了。

ETH 价格 = 3000 美元 : (50% ETH, 50% USDC) ETH 价格 = 2500 美元 : (70% ETH, 30% USDC) -> 资产全部取出 现在，假设我们可以在当前价格范围内输入机枪池的两者最大金额为 30％ ETH 和 30％ USDC。

Vault 的工作是先提取所有流动性，然后投下由 30％ ETH、 30％ USDC 组成的基础订单和由 40％ ETH，0 USDC 组成的限价 / 重新平衡订单。

基础订单 : (30% ETH, 30% USDC) -> 按当前价格范围下单 限价 / 重新平衡订单 : (40% ETH, 0 USDC) -> 下单的价格范围 ≥ 现价 , 例如 : (2500, 2600), 这样当价格上涨时 ETH 可以被兑换成 USDC。

如果 ETH 有结余，以高于当前价格的区间值投入 ETH。

同样，如果我们有 USDC 结余，则将结余的 USDC 投入价格 ≤ 当前价格的范围内，这样当价格下跌时，可以将 USDC 兑换为 ETH。

限价 / 重新平衡订单的作用是避免直接 swapping （将 20％ ETH 兑换成 20％USDC），那样做会导致被收取 0.1〜1％ 的交易费，而是要通过提供流动性自然地发生 swapping，这样不花一分钱手续费，甚至还可以赚取交易费。

又产生了一个问题：如果ETH一直跌，不上涨。按上面的限价单就无法成交了（下单的价格范围 ≥ ETH现价）

二：SQL分析

-- Uniswap v3 LP 操作策略——Alpha Vault
-- postgresql 在一条sql语句中使用多个with。就是这个写法，不用纠结。

-- 交易对临时表
-- 1、用户将资产存入到vault里面，所以关联交易对mint事件表的时候，资产的所有者相当于vault的合约地址
-- 2、交易对mint事件表中contract_address字段的地址是Uniswap V3: USDT的合约。
-- 3、工厂创建池事件表中contract_address字段的地址其实指的是提供流动性后nft的合约。pool地址才是交易对的合约地址
-- 4、串联下：用户存入到Vault，Vault作为owner和sender将资产发送到Uniswap V3: USDT的合约，通过合约地址即可拿到交易对两个token的地址。
WITH pairs AS (
    SELECT
        charm.contract_address AS vault, 
        fac_pool.token0,
        fac_pool.token1 
    FROM
        charm."AlphaVault_evt_Deposit" charm       -- Alpha Vault 存入事件表
        INNER JOIN uniswap_v3."Pair_evt_Mint" AS uni  -- 交易对mint事件表
            ON charm.contract_address = uni.owner
        INNER JOIN uniswap_v3."Factory_evt_PoolCreated" AS fac_pool  -- 工厂创建池事件表
            ON uni.contract_address = pool 
    GROUP BY  -- 等于去重效果
        1,
        2,
        3 
    ),
-- 	存入与提取临时表
-- 用了union all，相当于将几个查询的结果合并到一起（用union all的时候，列数需要相同）。只要读懂一个select的逻辑，就都明白了。
    deposits_and_withdrawals AS (
-- 以下开始是计算token存入的逻辑。
    SELECT
        evt_block_time,
        amount0 / 10 ^ decimals * price AS amount   -- 10^6表示的是10的6次方。prices库usd表有decimal字段，申明了小数点精度
    FROM
        charm."AlphaVault_evt_Deposit" charm
        INNER JOIN pairs ON vault = charm.contract_address      -- 通过合约地址关联上面的pairs表，从pairs表得到token地址。
        INNER JOIN prices.usd p ON token0 = p.contract_address  -- 用tonken地址关联，从prices库中的usd表取出token的价格
        AND date_trunc ( 'minute', evt_block_time ) = MINUTE 		-- MINUTE是prices库中的usd表字段。相当于交易发生时候的token价格
        
    UNION ALL
    
    SELECT
        evt_block_time,
        amount1 / 10 ^ decimals * price 
    FROM
        charm."AlphaVault_evt_Deposit" charm
        INNER JOIN pairs ON vault = charm.contract_address
        INNER JOIN prices.usd p ON token1 = p.contract_address 
        AND date_trunc ( 'minute', evt_block_time ) = MINUTE 
        
    UNION ALL
    
-- 	以下开始是计算token提现的逻辑。所以amount为负数
    SELECT
        evt_block_time,
        - amount0 / 10 ^ decimals * price 
    FROM
        charm."AlphaVault_evt_Withdraw" charm
        INNER JOIN pairs ON vault = charm.contract_address
        INNER JOIN prices.usd p ON token0 = p.contract_address 
        AND date_trunc ( 'minute', evt_block_time ) = MINUTE 
        
    UNION ALL
    
    SELECT
        evt_block_time,
        - amount1 / 10 ^ decimals * price 
    FROM
        charm."AlphaVault_evt_Withdraw" charm
        INNER JOIN pairs ON vault = charm.contract_address
        INNER JOIN prices.usd p ON token1 = p.contract_address 
        AND date_trunc ( 'minute', evt_block_time ) = MINUTE 
    ) 
    
-- 根据上面的”临时表“求和
SELECT
    evt_block_time,
    -- 这个over跟hive里面应该是一样的。属于开窗函数。相当于根据时间排序。hive里面经常搭配partition by使用。比如一个班的同学考试成绩排名
    sum( amount ) OVER ( ORDER BY evt_block_time )  
FROM
    deposits_and_withdrawals

deposits_and_withdrawals 里面用了多次前面with as创建的表pairs。相当于子查询，非常影响效率，我想是因为dune不给用户创建临时表的权限吧。要不然创建只在当前session生效的临时表，会比子查询快多了。

2022年6月3日 端午节安康。

今天主要分享如何利用爬虫爬取区块链浏览器上的交易列表数据。

原因

dune上没有bsc链上的转账明细数据表。Footprint Analytics上现有的bsc_transactions表transfer_type粒度不够。

环境

python 3.7

数据存储：mysql 5.7

缓存：redis 6.2.6

开发工具：pycharm

思路

（1）所有协议、合约、swap地址转账信息全爬不太实际，对存储要求比较高。所以针对需要分析的协议，专门去爬取对应智能合约转账是个不错的选择。

（2）区块链浏览器肯定是有反爬机制的。所以在代理选择上，要选择国外的代理。国内的代理都访问不到，具体原因你懂的。本文中不涉及代理部分，因为国外的代理厂家之前没有了解过。不过即使是上代理，对代码层面改动也比较小

（3）采用了urllib同步请求 + 范围内随机时长程序休眠。减少了被风控的概率。但是也降低了爬虫的效率。

后面再研究用scrapy或异步请求 [1]

[1] 同步：请求发送后，需要接受到返回的消息后，才进行下一次发送。异步：不需要等接收到返回的消息。

实现

找到需要爬取合约的具体地址：

第一页

http://bscscan.com/txs?a=0xbd3bd95529e0784ad973fd14928eedf3678cfad8

第二页

https://bscscan.com/txs?a=0xbd3bd95529e0784ad973fd14928eedf3678cfad8&p=2

第三页

https://bscscan.com/txs?a=0xbd3bd95529e0784ad973fd14928eedf3678cfad8&p=3

....

可以知道 p = ？就代表页数。

然后F12 点击“网络”，刷新界面，查看网络请求信息。

主要查看，网页上显示的数据，是哪个文件响应的。以什么方式响应的，请求方法是什么

如何验证呢，就是找一个txn_hash在响应的数据里面按ctrl + f去搜索，搜索到了说明肯定是这个文件返回的。

查看响应的数据，是html的格式。在python里面，处理html数据，个人常用的是xpath（当然，如果更擅长BeautifulSoup也可以）

在python里面安装相关的依赖

pip install lxml ‐i https://pypi.douban.com/simple

同时在浏览器上安装xpath插件，它能更好的帮助我们获到网页中元素的位置

XPath Helper - Chrome 网上应用店 (google.com)

然后就可以通过插件去定位了，返回的结果是list

**注：**浏览器看到的网页都是浏览器帮我们渲染好的。存在在浏览器中能定位到数据，但是代码中取不到值的情况，这时候可以通过鼠标右键-查看网页源码，然后搜索实现

# 请求和xpath定位具体实现代码：
def start_spider(page_number):
    url_base = 'http://bscscan.com
/txs?a=0xbd3bd95529e0784ad973fd14928eedf3678cfad8&'
​
    # 请求头
    headers = {
        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36',
        'referer': 'https://bscscan.com/txs?a=0xbd3bd95529e0784ad973fd14928eedf3678cfad8'
    }
​
    # 需要传入的参数
    data = {
        'p': page_number
    }
​
    # 将参数转为Unicode编码格式
    unicode_data = urllib.parse.urlencode(data)
​
    # 拼接网址
    # http://bscscan.com/txs?a=0xbd3bd95529e0784ad973fd14928eedf3678cfad8
    url = url_base + unicode_data
​
    # 自定义request对象
    request = urllib.request.Request(url=url, headers=headers)
​
    # 模拟浏览器发送请求
    response = urllib.request.urlopen(request)
​
    # 将返回的数据利用lxml转为
    tree = etree.HTML(response.read().decode('utf‐8'))
​
    # //div[@id='paywall_mask']//tbody//td//span/a[@class='myFnExpandBox_searchVal']/text()
    txn_hash_list = tree.xpath("//div[@id='paywall_mask']//tbody//td//span/a[@class='myFnExpandBox_searchVal']/text()")
​
    # //div[@id='paywall_mask']//tbody//td//span[@class='u-label u-label--xs u-label--info rounded text-dark text-center']/text()
    method_list = tree.xpath(
        "//div[@id='paywall_mask']//tbody//td//span[@class='u-label u-label--xs u-label--info rounded text-dark text-center']/text()")
​
    # //div[@id='paywall_mask']//tbody//td[@class='d-none d-sm-table-cell']//text()
    block_list = tree.xpath("//div[@id='paywall_mask']//tbody//td[@class='d-none d-sm-table-cell']//text()")
​
    # //div[@id='paywall_mask']//tbody//td[@class='showAge ']/span/@title
    age_list = tree.xpath("//div[@id='paywall_mask']//tbody//td[@class='showAge ']/span/@title")
​
    # //div[@id='paywall_mask']//tbody//td/span[@class='hash-tag text-truncate']/@title
    from_list = tree.xpath(
        "//div[@id='paywall_mask']//tbody//td/span[@class='hash-tag text-truncate']/@title")
​
    # //div[@id='paywall_mask']//tbody//td[@class='text-center']/span/text()
    transfer_type_list = tree.xpath("//div[@id='paywall_mask']//tbody//td[@class='text-center']/span/text()")
​
    # //div[@id='paywall_mask']//tbody//td/span/span[@class='hash-tag text-truncate']//text()
    to_list = tree.xpath("//div[@id='paywall_mask']//tbody//td/span/span[@class='hash-tag text-truncate']//text()")
​
    # //div[@id='paywall_mask']//tbody//td/span[@class='small text-secondary']/text()[2]
    transfer_free_list = tree.xpath(
        "//div[@id='paywall_mask']//tbody//td/span[@class='small text-secondary']/text()[2]")

然后就是利用redis，对txn_hash去重，去重的原因是防止一条数据被爬到了多次

def add_txn_hash_to_redis(txn_hash):
    red = redis.Redis(host='根据你自己的配置', port=6379, db=0)
    res = red.sadd('txn_hash:txn_set', get_md5(txn_hash))
    # 如果返回0，这说明插入不成功，表示有重复
    if res == 0:
        return False
    else:
        return True
​
​
# 将mmsi进行哈希，用哈希去重更快
def get_md5(txn_hash):
    md5 = hashlib.md5()
    md5.update(txn_hash.encode('utf-8'))
    return md5.hexdigest()

最后一个需要考虑的问题：交易是在增量了，也就是说，当前第二页的数据，很可能过会就到第三页去了。对此我的策略是不管页数的变动。一直往下爬。全量爬完了，再从第一页爬新增加的交易。直到遇到第一次全量爬取的txn_hash

最后就是存入到数据库了。这个没啥好说的。

以上就可以拿到转账列表中的txn_hash，后面还要写一个爬虫深入列表里面，通过txn_hash去爬取详情页面的信息。这个就下个文章再说，代码还没写完。

今天就写到这里。拜拜ヾ(•ω•`)o

介绍

izumi Finance 是首个为部署在以太坊链上的去中心化交易所Uniswap V3版本提供可编程流动性即服务的基础设施。

（LaaS：Infrastructure as a Service的缩写，意思是基础设施即服务。指把IT基础设施作为一种服务通过网络对外提供，并根据用户对资源的实际使用量或占用量进行计费的一种服务模式。在这种服务模型中，普通用户不用自己构建一个数据中心等硬件设施，而是通过租用的方式，利用 Internet从IaaS服务提供商获得计算机基础设施服务，包括服务器、存储和网络等服务）。【1】

同时，izumi通过内置的去中心化交易所将流动性服务提供到多条公链上。它将帮助在Uniswap V3版本上提供流动性的流动性提供者获取额外的流动性挖矿奖励和交易费用。另一方面，izumi将高效和持久的帮助DeFi协议吸引更多的流动性。

izumi通过LiquidBox使协议能够在特定价格范围内分配激励奖励，从而达到提高激励效率的目的。同时，流动性提供者可以以资本效率赚取更多的交易费用，并获得相关协议提供的额外激励。如：稳定币矿池仅在狭窄的价格范围内发放激励奖励（0.99~1.01）。

izumi通过提供结构化的激励和自研模块解决了“pool 2 困境” 的问题，同时为流动性提供者提供非无常的损失流动性挖掘。

【1】来源于百度百科：https://baike.baidu.com/item/IaaS

流动性即服务 （LaaS） 路线图：

a. Uniswap V3上的LaaS：LiquidBox

izumi Finance LiquidBox通过Uniswap v3 LP NFT提供可编程流动性挖掘（LM）工具，使协议能够在特定价格范围内精确有效地提供激励，从而优化流动性分配并鼓励用户抵押Uniswap V3 LP代币以获得额外奖励。

b. 多链上的离散化流动性AMM：iZiSwap

将Uniswap V3等集中式流动性服务扩展到多链。iZiSwap将支持限价订单，并且它将与订单簿和Uniswap V3兼容，从而提高多链的资本效率。

c. 桥梁上的集中流动性服务：C-AMM桥梁

多链时代需要快速、去中心化、自动再平衡的跨链桥。 izumi 的 C-AMM 桥使跨链交易成本低于 1 分钟，且 Gas 费低。跨链安全将由去中心化和透明的多验证者中继网络来保证。

个人思考：

老实说，简介大概意思明白了。但是很多单词不好翻译，比如non-impermanent loss liquidity mining，用软件翻译出来是“非永久性丧失流动性的采矿”

路线图是看明白了，一共要做三个部分，分别是

（1）Eth链上uniswap lp nft的流动性，类似convex和crv，去convex质押curve平台的crv获取convex平台的token、手续费等额外的收益。

（2）dex，挖金矿的铲子，不用多说。

（3）跨链桥，跨链桥是属于技术难度比较高的，毕竟很多时候经常看到消息说某某跨年桥被盗了。主要实现我记得有三种，原子互换、中继链或侧链实现的流动性聚合、验证人。

3.1 原子互换（hash time lock）

点对点跨链，如从eth转到polygen，提交需求后，会匹配一个流动性节点，将想要跨链的资产转移到流动性节点的eth地址，当节点收到资产后，会锁定资产并且在将流动性节点在polygen节点上的资产转移到用户的polygen钱包中。

总结：安全高，流动性割裂

产品：cBridge 1.0

3.2 中继链或侧链实现的流动性聚合

部署侧链或中继链，有自己相对独立的安全、共识机制，并且部署了不同的智能合约在多个链上。鼓励用户在不同链上提供流动性以获取token等奖励。

总结：不同链的流动性集中都可以通过链去智能管理，支持跨链的类型比原子交换的多，并且有独立的经济模型。

合约和链之前的漏洞会产生相互影响

产品：cBridge 2.0、hop、anyswap

3.3 验证人机制

和第二类在不同链上部署合约相似，区别在于多链上智能合约的集中管。理是由多签地址或者少数人管理的模式。

验证人相对少造成交易成本低，速度快。因为验证人少，所以用户使用是建立在验证人不会作恶的情况上。

产品：heco和bsc的桥（多签方式作为验证人）

LiquidBox

什么是LiquidBox

izumi 团队首先提出并实施了基于 Uniswap V3 NFT LP 代币的流动性挖矿方案“LiquidBox”。与传统的V2可替代LP代币直接质押挖矿不同，在LiquidBox中设计流动性挖矿激励计划时，协议可以明确设置被激励的LP代币的价值范围。并且用户将V3 LP代币质押到izumi协议后，izumi的LiquidBox会自动判断LP代币的价值范围是否在项目方设定的流动性激励价值范围内。如果在该范围内，LiquidBox 将根据激励方案为流动性提供者发放流动性挖矿代币奖励。

什么是Uniswap V3 NFT？

与Uniswap V2仅允许LP在从0到无穷大的全价范围内提供流动性相比，Uniswap V3允许LP在一定的价格范围内。LP在增加流动性后收到NFT（不可替代令牌），并且由于头寸的不可替代性，费用收入被单独存储并作为支付费用给代币持有者

为什么协议需要LiquidBox来获得流动性？

注：这里说的是LiquidBox几种不同类型的可编程的流动性挖矿模型

项目各方可以基于Uniswap V3建立货币对和流动性池，通过在有限范围内提供奖励和在不同价格范围内提供不同的奖励来更有效地吸引流动性。

选项1：“集中流动性挖掘模式”，稳定币和挂钩资产的固定奖励价格范围

izumi LiquidBox能够在某些价格范围内分发流动性挖掘激励代币，例如[0.95，1.05]，以保持稳定币或挂钩资产的价格稳定。

每个在（0.95p，1.05p）价格范围内的块，都将从稳定币和挂钩资产发行人那里获得10个代币。

izumi评估（0.95p，1.05p）价格范围内的总有效流动性，并根据每个LP持有的比例线性分配激励。激励措施将流动性吸引到这个价格范围内，从而实现最小的滑点。

图片地址：

https://lh4.googleusercontent.com/XvhU0lCq3YboluYhRO8GZsem-_FPEV6jsH7Ryv1400e-UBZphTXJFKeXIWiWMPnz0fAl0O8im8vPGnoDff8F0F_Yfe0WqL0OkSzRlad71VABUrLXMlgUUYOGhoY5nw

注：

如果LP在过度覆盖的价格范围内提供流动性（0.95p，1.05p），则仅将（0.95p，1.05p）内的流动性计算为激励分配的权重;

如果LP提供的NFT价格范围在（0.95p，1.05p）内，例如（0.98p，1.02p），则应用权重惩罚因子。

分析：与xy=k模型相比，0.95-1.05区间的资本效率高出50倍以上，只需要五分之一的TVL和相同滑点的激励。

个人思考

1、解读集中流动性意味着更高的无常损失

稳定币波动区间有限，收取的手续费与当前提供在该范围内的流动性正相关。

2、james文章所属中，“基于不同项目方对于币价波动幅度的不同需求”的理解

因为是LP限制了区间，对于价格波动大的币，如果区间设置过小，则不能拿到所有的流动性激励。设置过大，则减小了资金使用效率。尽可能将资金集中在成交量大的区间以获取高的激励奖励。项目方可以通过调整区间的奖励，去提升币价。

3、注部分内容

当提供LP的区间包裹了（0.95p，1.05p）这个范围，权重仅计算（0.95p，1.05p）的

当提供LP的区间介于（0.95p，1.05p）区间内，不能获取到百分百的权重，会有部分惩罚权重

4、只有选项1：“集中流动性挖掘模式”是需要在uniswp上有LP NFT。

选项2：新兴资产的“单边非无常损失挖掘模型”，使价格持续上涨时流动性挖掘更具吸引力

izumi LiquidBox允许在当前价格范围内进行流动性挖掘激励代币，以补偿相应时间间隔内价格变化造成的无常损失。

与传统的xy=k模型类似，LP将一半USDC和一半项目代币放入LiquidBox中，一键开始流动性挖掘。【1】

然而，为了避免传统xy=k模型（即LP将所有USDC作为潜在买单，将项目代币作为潜在卖单组交易对放入流动性池）造成的“池2困境”，导致流动性提供者在项目代币上涨时被动出售其项目代币从而遭受无常损失。也增加了项目方的被动抛售压力，阻碍了价格上涨，造成了“双输”的局面。

LiquidBox创新了基于Uniswap V3的“单边非无常亏损”模型，将USDC放入（Pa，Pc）价格的流动性区间，略低于当前价格的Pc【2】，并将项目代币放入质押挖矿而不是交易池（即将高于Pc作为潜在卖家），从而创建了一个“买强于卖出”的模型， 这更有利于价格上涨。

图片地址：

https://1156263563-files.gitbook.io/\~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbFrz9ebdFK9k9KnHCnY%2Fuploads%2F7VzHYNp1eUR444IzKVJU%2FMG63.jpeg?alt=media&token=ce57e6ad-8ffc-41a3-98b2-4b15f07add72

例如，如果XYZ代币的当前价格为3 USDC/个，LP将一键将1000个XYZ和3000个USDC存入izumi平台进行挖矿，并获得总本金的90%APR（类似于Sushiswap xy =k模型）。

izumi通过在Uniswap V3上（0，3）价格范围内放置3000个USDC来管理，当XYZ价格下跌用USDC形成购买订单。1000个XYZ被放置在izumi质押模块中以锁定流动性（质押部分不在Uniswap V3中），在XYZ价格上涨时不会被动出售，从而不会对项目方造成无常损失或被动抛售压力。

分析：当价格上涨时，没有无常损失；当价格下跌时，LP的无常损失百分比（Pa=0）与xy=k相同。项目的总体分布式激励与 xy=k 模型中相同。在上升周期中，被动卖出流动性较低，而在下降周期中，买入支撑位是一致的（如果Pa大于0，则购买力也会增强）。【3】

个人思考：

【1】"the LP also puts half value of the USDC and half value of the project tokens into the izumi LiquidBox",按举例理解

【2】Pa <= price < Pc

【3】我是理解为：3000USDC，在XYZ价格下跌的时候，会买入XYZ，变相提供流动性。1000XYZ不会被动出售，可以由用户主动出售。项目方的无常损失就类似与terra的挤兑，大家都想跑，项目方和做市商亏了不少。

Pa=0意味着，LPs手上全是XYZ，没有USDC了。

上升周期，因为是质押了，所以抛压小了 = 被动卖出流动性较低。

如果Pa大于0，则购买力也会增强 = XYZ跌的越多，买的越多，直到USDC没了，或者Pa = 0

选项3：“主动区间挖矿”模型激励非稳定代币围绕当前价格提供动态流动性。

从本质上讲，该项目激励流动性提供者围绕当前价格提供有效流动性，并且项目所有者奖励的百分比是通过计算他们积极提供有效流动性的时间来计算的。

选项4：“与交易费用成比例的额外奖励模式”，用于激励专业做市商的协议

在流动性提供者质押Uniswap V3 NFT到izumi LiquidBox之后，izumi 分析该 LP NFT 在整个质押期间赚取的交易费用，并提供项目提供的额外激励。【1】

例如，用户提供XYZ-USDC流动性，生成LP NFT，并将其抵押在LiquidBox中，项目所有者在此期间提供额外的1倍的费用奖励。当用户在取出 NFT 并领取佣金时，将获得 30 XYZ 和 90 USDC，并且他可以从 LiquidBox 获得额外的 60 XYZ 奖励。

分析：该方案相当于项目方为专业做市商提供额外补贴，让专业做市商即使在前期代币低市值导致不够收益无法弥补交易费的情况下，也可以动态调整仓位至当前价格区间，做市商可以获得交易费用乘数以实现盈利。

原因是在 Uniswap V3 中，Taker （吃单）费用无法分配给特定的 Maker（挂单）（LP），因此，只要做市商不提供超过 50% 的有效流动性且无法达成合谋——做市商虚假交易（既充当吃单又充当做市商）的费用成本高于平台奖励。所以，这种虚假交易是没有动机的。

个人思考：

【1】“After staking Uniswap V3 NFT in the izumi LiquidBox for liquidity providers or LPs” liquidity providers 和 LPs都表示流动性提供者

选项 5：“锁定期单侧挖矿模式”，用于看跌卖出期权

流动性提供者可以在 Uniswap V3 上将流动性置于低于 当前价格Pc 的价格范围内，并锁定 LP NFT 一段时间，这本质上相当于在价格下跌时提供被动购买支持。从金融产品的角度来看，它接近于看跌期权，既可以作为项目方出资为社区购买的公共产品，也可以作为借贷平台用来对冲清算购买的保险产品。【1】

例如，如果XYZ=3USDC，LP在（1.5，2.4）价格范围内放置了10000 USDC的流动性并锁定头寸30天，则LP可以在锁定结束时获得10k*24%（APR）（*1/12）= 200USDC相当于XYZ的奖励（66.7pcs）

图像链接：

https://lh3.googleusercontent.com/McP1L0aYwS_blpFxiJCiDifKuAaGx0P80Jg8ctMiLCyVhwqK_JI3f5Gsg4M-duJQpk_i96Tf44n3oKmM0lbxwmWMiOswyh9OGnNUAhNpocPqQCMCzZJTuzH9pls7pQ

分析：当价格上涨或不低于2.4时，LP不会产生无常损失，这相当于单一代币收益APR = 24%;

当价格跌破2.4时，LP获得挖矿奖励，但承担无常损失。

注：项目侧奖励的APR可使用BSM期权公式计算，并随波动性、锁定时间、无风险利率等因素进行动态调整。每个周期都有限制，先到先得。【3】

个人思考

【1】short put，就是看好股票不能跌过目标价，卖出认沽期权，是看多。

卖出者获得权利金（权利金来自买入看跌期权），若买入看跌期权者执行合约，卖出方必须以特定价格向期权买入方买入一定数量的股票。当投资者预期股票价格上涨时，他往往卖出看跌期权。

权利金：是期权的买方为获取期权合约所赋予的权利而必须支付给卖方的费用

【3】BSM期权公式

https://zhuanlan.zhihu.com/p/256356619?utm_source=wechat_session

如何使用LiquidBox进行流动性挖掘？

假设您的项目已在Uniswap V3上列出，现在您希望激励特定价格范围的流动性。为了做到这一点，您希望用您的代币激励您的社区，并使流动性提供商能够获得额外的奖励，为此您需要izumi。

这个过程非常简单：

1）填写izumi激励池申请表这里.

2）izumi团队将与您联系以启动入职流程。

3）您支付每个池10,000美元的费用，以iZi代币支付。（免费至2022年1月底）

4）付款和信息提交后，我们部署。

如果您有任何疑问，请随时通过Discord和电子邮件与我们联系。

dc：https://discord.com/invite/vUFpSwxTzz

电子邮件：contact@izumi.finance

这个过程是如何展开的？

基于izumi的激励机制，项目团队需要决定一些关于UniV3流动性挖矿计划的细节，如激励价格范围、项目持续时间和激励代币数量等。如果您对这些参数有任何疑问，请随时与izumi团队联系，我们将根据项目情况提供建议。

然后项目团队需要填写izumi激励池申请表，这需要更多信息。

发送后，izumi的团队成员将与您联系以确认详细信息，解决任何问题并启动入职流程。

接下来会发生什么？

入职流程完成后，用户将能够在 Uniswap V3 上提供流动性，并直接在 izumi 主网站上的项目专用池中质押 LP NFT。这些流动性提供者将获得您的项目代币和额外的 iZi 代币的奖励。详细说明请阅读【教程】。用户可以在激励计划期间的任何时间以及在所有奖励分配后，根据需要提取他们的 Uni V3 LP NFT

iZUMi 债券（美元）

iUSD或iZUMi Bond USD 百分之百由iZUMi的抵押品和未来收入支持。iUSD与美元1：1挂钩，由iZUMi Finance发行，并作为债券出售给私人投资者，为iZUMi生态系统的未来发展筹集资金。

每周 25% 的 iZiSwap 收入将发送至 iZUMi 财政部，用于在二级市场回购 iUSD，直到 iUSD 价格升至 0.996 USDT 以上。如果 iUSD 价格连续 4 周低于 0.996 USDT，iZUMi 承诺在下周内使用国库基金回购并销毁 iUSD。 iUSD 的供应量永远不会超过 iZUMi 国库的总价值，以保证安全和透明。

iUSD 的使用案例

• 赌注赚取 每个人都可以以6%-20%的年利率投注或耕种iUSD，利息来自iZiSwap收取的交易费用，为零售用户提供稳定的收入产品

• 有激励措施的贸易

  为了增加iUSD的流动性，iZiSwap将激励与iUSD相关的交易对，包括农业激励和交易费用现金返还。

如何买卖 iUSD

投资者可以通过两种方式购买iUSD：私人销售和二级市场。参与私人销售至少需要100万美元的安置。买家还可以在DEX上交换iUSD。【1】

私人销售的投资者有权根据协议将iUSD兑换成美元。所有iUSD持有者都可以在多链上以USDT或以DEX的价格出售iUSD。

【1】购买债券需要100w刀以上。

代币经济学

token详情

a. 代币标准: ERC-20 Token on Ethereum

b. 股票代码: iZi

c. 总量: 20亿 iZi tokens

d. Ethereum Contract: 0x9ad37205d608B8b219e6a2573f922094CEc5c200 BSC(Binance) Contract: 0x60D01EC2D5E98Ac51C8B4cF84DfCCE98D527c747 Polygon Contract: 0x60D01EC2D5E98Ac51C8B4cF84DfCCE98D527c747 Arbitrum Contract: 0x60D01EC2D5E98Ac51C8B4cF84DfCCE98D527c747

token分配

图片地址：

https://1156263563-files.gitbook.io/\~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbFrz9ebdFK9k9KnHCnY%2Fuploads%2Fw8nqS1ff6edxFZ5cjzqW%2Fizumi_-01.jpg?alt=media&token=a0f9844e-2988-41b1-9a2d-801668018d35

流通计划

提案名称：2022-1 推广veiZi的提案

提案详情：

1. 所有投资者都将收到veiZi，而不是未来12个月的未投资iZi。

2. 所有veiZi将根据SAFT分发计划的最终发布日期设置为2023年3月20日解锁。

归属时间表的变化：

该提案将影响归属时间表的三个部分：私募，团队和伙伴关系。所有这些应该发布的iZi代币将在未来12个月内被锁定为veiZi。这些 veiZi 将于 2023 年 3 月 20 日解锁。

各链的池和发行

https://docs.izumi.finance/tokens/tokenomics#pools-and-emission

iZi 和 ve-iZi

iZi 令牌

iZi令牌是iZUMi 平台的实用型令牌，可用于支付跨链交易费用，激励池设置和其他工具的使用。此外，用户需要抵押iZi令牌才能获得ve-iZi令牌，这是iZUMi 平台的治理令牌，使持有者有资格获得一系列利益并参与治理。

iZUMi DAO veNFT（veiZi）

注意：当平台开始与iZUMi社区的DAO治理时，iZUMi Finance将推出veNFT。

1、什么是iZUMi DAO veNFT（veiZi）？

• iZUMi DAO veNFT（veiZi）是iZUMi Finance的治理令牌。

• veiZi旨在充分代表iZUMi Finance的治理权利。

• veiZi，由锁定的iZi数量和时间计算，描述了投票权。

veiZi与ERC721标准兼容，该标准可以像其他NFT一样转移和交易。

2、如何计算veiZi的投票权？

• x1：锁定号码 （iZi）

• x2：锁定时间剩余（块），最长4年

• veiZi 投票权 =x1 * (x2 / 4)

注意：此算法将 veiZi 的投票权设置为金额和时间加权，这适用于表示社区成员对 iZUMi Finance 的支持和信心。

3、veiZi的功能是什么？

• 投票：

将采用DAO治理和二次投票来确定关键问题。每个周期的iZi排放量将根据veiZi投票权确定和分配。veiZi的所有者可以将投票权委托给另一个地址。

• 质押：

平台收入的50%将用于回购iZi，并根据每月的投票权发送给veiZi持有者。在前4年，每年将向veiZi持有者发送4000万iZi质押奖励。

• 提高：

随着NFT的质押，veiZi将用于将LiquidBox池的APR提高到2.5倍。提升机制将通过取两个值中的较小金额来计算您的收入权重。第一个值很简单，它是用户在iZUMi平台上从UniV3 LP NFT计算的vliquidity量。此金额是您的最大收入权重。

min((vliquidity∗40/100)+(Totalvliquidity∗VotingPower/VotingTotal∗(100−40)/100）,vliquidity)min（（vliquidity∗40/100）+（Total vliquidity∗Voting Power/Voting Total∗（100−40）/100），vliquidity）min（（vliquidity∗40/100)+(Totalvliquidity∗VotingPower/VotingTotal∗（100−40）/100），vliquidity)

注意：此算法是根据曲线增强算法设计的。

4、如何获得 veiZi？

• 任何地址都可以通过在一定的锁定时间内锁定iZi来创建veiZi。

• 任何地址都可以转移或接收veNFT，这意味着veNFT可以在像Opensea这样的NFT市场上进行交易。

• 任何地址都可以将iZi添加到任何veiZi中，而不会影响锁定时间

• 如果 B 的锁定时间长于 A，则任何地址都可以将 A veNFT 与 B veNFT 组合在一起，并且 A 的锁定编号将被添加到 B 的中。

• 只有所有者的地址可以将锁定时间延长至4年，不支持提前解锁。

5、如何赎回veiZi？

用户可以赎回veiZi并在达到锁定时间（块）后重新锁定iZi。

1. 如何使用您的地址使用/抵押 veiZi？

• 质押：每个地址都可以押注一个且只有一个 veiZi。

• 取消积分可在您领取所有奖励后随时使用。如果您在领取农业池奖励之前取消了veiZi，则由于取消了提升，您的农业奖励可能会减少。

6、你为什么需要veiZi？

• veiZi减少了iZi在二级市场的流通量

• veiZi每个月都可以获得质押奖励，使其成为一种有息资产。

• 下注一次veiZi，它可以无限次使用，以提高农业池的奖励。

• 不用担心锁定iZi的流动性。veiZi可以在主流的NFT市场进行交易，比如Opensea。

路线图

2021年第四季度

• 推出基于Uniswap V3的Liquidbox;

• 离散化流动性AMM研究;

2022年第一季度

• 向其他协议提供流动性即服务（双重挖矿收益）;

• 将LiquidBox扩展到多链;

• 启动 ve-iZi 和排放治理;

2022年第二季度

• 在多链上推出内置AMM;

2022年第三季度

• iZiBAR中的更多工具;

• 构建合作伙伴生态系统;

2022年第四季度

• Dao治理;

后面部分为FAQ问题解答以及操作指南

FAQ：https://docs.izumi.finance/faq/iziswap-fee-tier-and-fee-distribution

指南：https://docs.izumi.finance/tutorial/iziswap-guide

Linux作为一个开源的系统，经常被安装在服务器上。对比于windows，有着定制化程度高、稳定性好、命令行强大等特性。

对于技术上的学习，用于需要理论+实操。如果单重视理论知识而不动手操作，则永远不会体验到Liunx的如丝般顺滑。当然，其他技术也是如此。

二：安装VMware虚拟机软件

将系统装在虚拟机上有两个好处，一：与真实环境隔离，不使用时不影响。二：虚拟机环境可随时删除，重装。

VMware软件和CentOS7光盘镜像ISO文件下载

https://drive.google.com/file/d/1ZBu8M2oeP_i9ERHO0ycC_hFwzIrj9UhQ/view?usp=sharing

https://drive.google.com/file/d/14FOz55jBdIZ_n98jjyvz6LEOgrmCC4pZ/view?usp=sharing

软件打开首页

点击创建新的虚拟机按钮

下一步

选择CentOS7 ISO。文件路径尽量不要使用中文。

填写虚拟机名称和选择虚拟机文件存放路径

选择cpu核数

选择内存大小

选择网络连接方式

默认即可，下一步

默认即可，下一步

选择创建新的磁盘

选择磁盘大小，选择虚拟磁盘存储为单个文件

默认即可，下一步

完成

回车开始安装

点击回车

等待进度条读取到100%

等待进入安装界面

注意：

以下界面都是在鼠标虚拟机内部点击，需要通过按Ctrl + Alt释放鼠标才可以正常操作点击真实的系统

选择中文

简体中文

直接鼠标点击虚拟机内部按钮就行。退出虚拟机按Ctrl + Alt

关闭KDUMP

去掉✔后点击完成

设置主机名，具体网络设置会在后续教程，因为要设置成静态ip，方便每次通过shell客户端去连接。

设置自定义分区

选择”我要配置分区“，然后点击完成

点击添加

添加/boot分区，主要存放启动文件

添加/home分区，存放非root用户文件。root用户目录在~下

设置swap交换分区。当内存不足的时候，会把一部分硬盘空间虚拟成内存使用,从而解决内存容量不足的情况。当然，影响性能。

剩下的空间全部给/目录。企业开发中，还有一个/data分区，数据和软件系统分离，保证数据安全。但是这里是学习，就不做了。

在linux中，根目录“/”是位于文件系统目录结构的顶层，是最顶层的目录，所有的文件和目录都置于根目录“/”之下；根目录“/”下面还有“/bin”，“/home”，“/usr”等子目录。

点击完成

接受更改

点击开始安装

修改root密码

等进度条完成后点击重启按钮

回车即可

显示登陆界面即是完成安装

用root密码登陆，输入

sync # 将所有未写的系统缓冲区写到磁盘中
poweroff # 关机时同时关闭电源。关机命令在7之前还有halt、shutdown，因为7采用了systemd管理，都是以符号链接到/bin/systemctl的，所以7之后就没区别了。