@cardinal/namespaces

中文文档
6.0.0发布于 2023/03/08AGPL-3.0ESM + CJS近 30 天下载 2569

红衣主教命名空间 SDK

中文使用文档
文档目录7 节
  1. 背景情况
  2. 软件包
  3. 地址
  4. 开始
  5. 文档
  6. 问题与支持
  7. 许可证

红衣主教命名空间

License Release

NFT 定值和订阅协议

背景情况

可以将命名空间视为一套模板参数的租赁分配器,使NFT公司能够按程序计价并按要求租用。 与Metaplex糖果-机器类似,这通过将NFT做成薄荷并随后用所配置参数的符号管理器来包装来工作. 返回取名空间后,可以再由新用户租用.

  • 用户名
    • 在从给定命名空间租借用户名时,您可能租借游戏,访问服务,或参与DAO的权利. 用户名以管理式NFT的形式出现,该NFT在租房期间坐在钱包中.
  • 验证所有权
    • 拥有一个租来的,管理的NFT 从一个命名空间 之前已经核实你的身份, 允许你维护 已经证明的所有权 在该命名空间内的东西.
  • 订阅
    • 可以设置一个取名空间,提供基于订阅的入门内容. 当用户试图访问内容时,提供者可以轻而易举地检查NFT的所有权.
  • 密钥/ 车票
    • 命名空间可以代表旅馆中可以临时租用的房间。 所租用的钥匙也可能有按用期到期,并用作活动票.
  • 徽章/ 证书
    • 可以设置一个取名空间,将徽章或证书出租给特定的一组用户. 用户可以通过命名空间批准,然后要求其徽章可以被核实为由该命名空间签发和管理.

软件包

软件包说明版本文档
cardinal-namespaces点播 NFT 薄荷Crates.ioDocs.rs
@cardinal/namespaces命名空间的脚本 SDKnpmDocs

地址

程序地址在devnet,testnet,和主网-beta上相同.

开始

git clone https://github.com/cardinal-labs/cardinal-namespaces.git
cd cardinal-namespaces
make

文档

名片

命名空间是协议的基础组成部分. 一个取名空间是程序拥有的PDA,在通称下组成了NFT的逻辑分组. 通常类似于TLD(顶级域),但命名空间的使用可以相差很大. 基本上一个命名空间是属于命名空间的符号的创建者. 它包含一个可以更新命名空间参数的权威,当用户在命名空间中声称条目时,它们由命名空间发布.

#[account]
pub struct Namespace {
    pub bump: u8,
    pub name: String,
    pub update_authority: Pubkey,
    pub rent_authority: Pubkey,
    pub approve_authority: Option<Pubkey>,
    pub schema: u8,
    pub payment_amount_daily: u64,
    pub payment_mint: Pubkey,
    pub min_rental_seconds: i64,
    pub max_rental_seconds: Option<i64>,
    pub transferable_entries: bool,
}

名称条目

取名空间是取名条目的集合. 每个名称条目存储与命名空间中特定名称相关的信息. 最重要的是,名称来源于名称和取名空间,因此每个条目都是给定名称空间所独有的. 该条目主要用于将字符串名称映射到NFT(薄荷地址). NFT的持有者有能力设置输入数据,并使用反向输入将其地址映射回该名称.

名称条目NFT是使用干线生成器动态生成的.

名称条目根据命名空间的参数由命名空间发布. 命名空间使用主控键来创建代表每个条目的可撤销和过期的NFT. 这个设置允许订阅,以及由命名空间所发可撤销的徽章.

#[account]
pub struct Entry {
    pub bump: u8,
    pub namespace: Pubkey,
    pub name: String,
    pub data: Option<Pubkey>,
    pub reverse_entry: Option<Pubkey>,
    pub mint: Pubkey,
    pub is_claimed: bool,
    pub claim_request_counter: u32,
}

问题与支持

如果你正在使用红衣主教命名空间合同和图书馆进行开发, 请随意向Discord寻求支持。 我们将与你或你的团队合作,回答问题,提供发展支持并讨论新的特征请求.

对于问题,请提交 GitHub 问题.

https://discord.gg/cardinallabs (英语)

许可证

红衣主教协议根据GNU Affero通用公共许可证 v3.0.

简言之,这意味着对这个代码的任何修改都必须公开源码,并且根据AGPL-v3.0许可证提供,即使只私下使用.

版本与发布记录

@cardinal/namespaces 共发布 177 个版本,首次发布于 2022/01/05;过去 12 个月发布了 0 个版本。

版本发布日期距今
6.0.0latest2023/03/083 年前
5.0.12023/03/013 年前
5.0.02023/02/063 年前
5.0.0-beta.02023/02/063 年前
4.1.612022/11/303 年前
4.1.602022/11/273 年前

关于 @cardinal/namespaces 的常见问题

@cardinal/namespaces 是什么?

红衣主教命名空间 SDK

如何安装 @cardinal/namespaces?

在项目目录运行 npm install @cardinal/namespaces,或使用 pnpm add / yarn add / bun add。

@cardinal/namespaces 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/cardinal__namespaces 是否存在。

@cardinal/namespaces 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cardinal/namespaces 可以商用吗?

@cardinal/namespaces 使用 AGPL-3.0 许可。最严格的 Copyleft:除分发外,通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括,不构成法律意见,请以许可原文为准。

@cardinal/namespaces 的下载量有多少?

根据 npm 官方下载统计,@cardinal/namespaces 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,569 次,日均约 86 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cardinal/namespaces 还在维护吗?

最新版本 6.0.0 发布于 2023/03/08(3 年前);至今共发布 177 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/01/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。