名可名 0.7.2

名可名 0.7.2

×

由John Chen和moky维护。

名可名 0.7.2

  • 由
  • Albert Moky

名可名 (Ming Ke Ming) -- 账户模块 (Objective-C)

license Version PRs Welcome Platform

本文档介绍了一个用于分散化用户身份验证的通用账户模块。

版权 © 2018-2019 Albert Moky

0. 元数据

元数据是由您的私钥生成的，可以用来创建实体的新ID或验证ID/PK对。

它包含4个字段

字段 描述
version 元数据算法版本
seed 实体名称
key 公钥
fingerprint 生成地址的签名

0.0. 版本

  • 0x01 默认版本
  • 0x02 BTC版本
  • 0x03 扩展BTC版本
  • 0x04 ETH版本
  • 0x05 扩展ETH版本

0.1. 种子

用于生成指纹的字符串与ID.name相同。

0.2. 密钥

由元算法将一个公钥（PK）绑定到一个ID。

0.3. 指纹

指纹字段由您的私钥和种子生成。

data = [seed dataUsingEncoding:NSUTF8StringEncoding];
fingerprint = [privateKey sign:data];

1. ID

用于标识一个实体（用户/组）。它由3个字段和2个扩展属性组成。

字段 描述
名称 与元种子相同。
地址 唯一标识
终端 登录点，为可选。
类型 网络类型
号码 搜索号码

ID格式为name@address[终端]。

1.0. 类型

一个人的网络类型是 8，群组是 16

typedef NS_ENUM(UInt8, MKMNetworkID) {
    /**
     *  Person Account
     */
    MKMNetwork_Main    = 0x08, // 0000 1000 (Person)
    
    /**
     *  Virtual Groups
     */
    MKMNetwork_Group   = 0x10, // 0001 0000 (Multi-Persons)
    MKMNetwork_Polylogue = 0x10, // 0001 0000 (Multi-Persons Chat, N < 100)
    MKMNetwork_Chatroom  = 0x30, // 0011 0000 (Multi-Persons Chat, N >= 100)

    /**
     *  Network
     */
    MKMNetwork_Provider  = 0x76, // 0111 0110 (Service Provider)
    MKMNetwork_Station   = 0x88, // 1000 1000 (Server Node)
    
    /**
     *  Internet of Things
     */
    MKMNetwork_Thing   = 0x80, // 1000 0000 (IoT)
    MKMNetwork_Robot   = 0xC8, // 1100 1000
};
typedef UInt8 MKMNetworkType;

1.1. 名称

“名称”字段是用户名，或只是群组的随机字符串

  1. 名称长度必须超过1字节，小于32字节；
  2. 应由a-z，A-Z，0-9或字符'_'，'-'，'.'组成；
  3. 不能包含关键字字符（'@', '/'）。
# Name examples
user_name  = @"Albert.Moky";
group_name = @"Group-9527";

1.2. 地址

“地址”字段是在Meta中使用指纹和网络ID创建的

static inline NSData * check_code(NSData *data) {
    assert([data length] == 21);
    data = [[data sha256] sha256];
    return [data subdataWithRange:NSMakeRange(0, 4)];
}

static inline UInt32 user_number(NSData *cc) {
    assert([cc length] == 4);
    UInt32 number;
    memcpy(&number, [cc bytes], sizeof(UInt32));
    return number;
}

@implementation MKMAddressBTC

/**
 *  BTC address algorithm:
 *      digest     = ripemd160(sha256(fingerprint));
 *      check_code = sha256(sha256(network + digest)).prefix(4);
 *      addr       = base58_encode(network + digest + check_code);
 */
- (instancetype)initWithData:(NSData *)key
                     network:(MKMNetworkType)type {
    NSString *string = nil;
    UInt32 code = 0;
    NSMutableData *data;
    
    // 1. hash = ripemd160(sha256(CT))
    NSData *hash = [[key sha256] ripemd160];
    // 2. _h = network + hash
    data = [[NSMutableData alloc] initWithBytes:&type length:1];
    [data appendData:hash];
    // 3. cc = sha256(sha256(_h)).prefix(4)
    NSData *cc = check_code(data);
    code = user_number(cc);
    // 4. addr = base58_encode(_h + cc)
    [data appendData:cc];
    string = [data base58Encode];
    
    if (self = [super initWithString:string]) {
        self.network = type;
        self.code = code;
    }
    return self;
}

@end

从网络获取实体ID的meta时，必须在接受其<强>公钥之前进行共识算法验证。

1.3. 终端

作为<强>登录点的资源标识符。

1.4. 数字

为了便于记忆，定义了搜索数字。其值转换为地址的校验码。它大于0，小于2的32次方（4,294,967,296）。

2. 示例

ID

# ID examples
ID1 = @"hulk@4YeVEN3aUnvC1DNUufCq1bs9zoBSJTzVEj";  // Immortal Hulk
ID2 = @"moki@4WDfe3zZ4T7opFSi3iDAKiuTnUHjxmXekk";  // Monkey King

元数据

/* Meta(JsON) for hulk@4YeVEN3aUnvC1DNUufCq1bs9zoBSJTzVEj */
{
    version     : 0x01,
    seed        : "hulk",
    key         : {
        algorithm  : "RSA",
        data       : "-----BEGIN PUBLIC KEY-----\nMIGJAoGBALB+vbUK48UU9rjlgnohQowME+3JtTb2hLPqtatVOW364/EKFq0/PSdnZVE9V2Zq+pbX7dj3nCS4pWnYf40ELH8wuDm0Tc4jQ70v4LgAcdy3JGTnWUGiCsY+0Z8kNzRkm3FJid592FL7ryzfvIzB9bjg8U2JqlyCVAyUYEnKv4lDAgMBAAE=\n-----END PUBLIC KEY-----",
        // other parameters
        keySize    : 1024,
        encryption : "PKCS1",
        signature  : "PKCS1v15SHA256"
    },
    fingerprint : "jIPGWpWSbR/DQH6ol3t9DSFkYroVHQDvtbJErmFztMUP2DgRrRSNWuoKY5Y26qL38wfXJQXjYiWqNWKQmQe/gK8M8NkU7lRwm+2nh9wSBYV6Q4WXsCboKbnM0+HVn9Vdfp21hMMGrxTX1pBPRbi0567ZjNQC8ffdW2WvQSoec2I="
}

(默认所有数据均使用BASE64算法进行编码，地址除外)