min-dev-java/docs/PacketFormat.md

MIN Packet Format

1. TLV

• 网络分组级别

  0 ~ 49

  Type	TLV number	Description
  PacketMINCommon	0	通用MIN网络包
  PacketMINManagement	1	MIN网络管理包
  PacketMINIP	2	MIN网络IP包

• 网络包分区

  50 ~ 99

  Type	TLV number	Description
  IdentifierField	50	目的标识区
  SignatureField	51	数字签名区
  ReadOnlyField	52	只读数据区
  VariableField	53	可变数据区
  VariableProtectField	54	可变数据区中的受保护区
  VariableDangerousField	55	可变数据区中的非受保护区

• 标识分配

  100 ~ 199

  Type	TLV number	Description
  IdentifierComponent	100	标识名称组件
  Identifier	101	标识值
  IdentifierCommon	102	身份标识
  IdentifierContentInterest	103	内容兴趣标识
  IdentifierContentData	104	内容数据标识

• 其它TLV组件

  200 ~ 500

  Type	TLV number	Description
  SignatureValue	200	签名值
  SignatureInfo	201	签名参数
  SignatureType	202	签名类型
  TlvKeyLocator	203	指示证书或公钥的位置
  Payload	204	网络包负载
  CanBePrefix	205	是否可以被较长的数据包前缀匹配
  MustBeRefresh	206	是否强制只拉取新鲜的数据
  InterestLifeTime	207	兴趣包生存期
  Nonce	208	随机数
  HopLimit	209	跳数限制
  FreshnessPeriod	210	数据包新鲜时间
  CongestionMark	211	拥塞标记
  TTL	212	Time to live
  SliceNumber	213	分片数量
  SliceSize	214	分片大小
  LogicFaceId	215	逻辑接口Id
  RemoteAddr	216	远端地址
  LocalAddr	217	本地地址
  Mtu	218	最大传输单元
  Ret	219	bool类型，成功或失败
  Origin	220
  Cost	221	链路开销
  Expires	222	LogicFace超时时间，-1为不超时（never）

2. Identifier

IdentifierComponent = 100 TLV-LENGTH
                      <Marker>
                      *OCTET
Marker = OCTET

Identifier = 101 TLV-LENGTH
             *IdentifierComponent

• *OCTET：字符串

• Marker：单个字节，用于区分不同类型的IdentifierComponent，分配如下

  Marker value	Description
  0x00	普通的UTF-8编码的字符串
  0x01	非负整数（可以用1、2、4、8个字节表示）
  0x02	任意字节数组

2.1 CommonIdentifier

CommonIdentifier = 102 TLV-LENGTH
                   <Identifier>

2.2 InterestIdentifier

InterestIdentifier = 103 TLV-LENGTH
                     <Identifier>

2.3 DataIdentifier

DataIdentifier = 104 TLV-LENGTH
                 <Identifier>

3. MIN Packet

3.1 CPacket

CPacket = 0 TLV-LENGTH
             { CommonIdentifier }          => 标识区
             { Signature }                 => 签名区
             {                             => 只读区
                 <Payload>
             }
             {                             => 可变区
                 {                         => 受保护区
                     "Empty"
                 }
                 {                         => 非受保护区
                     [TTL]
                 }
             }

• Payload

  Payload = PAYLOAD-TYPE TLV-LENGTH *OCTET
  

3.2 Interest

Interest = 0 TLV-LENGTH
             { InterestIdentifier }        => 标识区
             { Signature }                 => 签名区
             {                             => 只读区
                 [CanBePrefix]
                 [MustBeRefresh]
                 [InterestLifeTime]
                 [Nonce]
                 [HopLimit]
                 <Payload>
             }
             {                             => 可变区
                 {                         => 受保护区
                     [CongestionMark]
                 }
                 {                         => 非受保护区
                     "Empty"
                 }
             }

• CanBePrefix

  CanBePrefix = 203 
  							TLV-LENGTH; == 0 
  

• MustBeFresh

  MustBeFresh = 204
  							TLV-LENGTH; == 0 
  

• InterestLifeTime

  InterestLifeTime = 205 TLV-LENGTH NoNegativeInteger
  

  • NonNegativeInteger ：非负整数

• Nonce

  Nonce = 206
          TLV-LENGTH; == 4
          4OCTET
  

  • 4OCTET：四字节字符串

• HopLimit

  HopLimit = 207
             TLV-LENGTH; == 1
             OCTET
  

  • OCTET：1字节无符号整数

3.3 Data

Data = 0 TLV-LENGTH
             { DataIdentifier }            => 标识区
             { Signature }                 => 签名区
             {                             => 只读区
                 [FreshnessPeriod]
                 <Payload>
             }
             {                             => 可变区
                 {                         => 受保护区
                     [CongestionMark]
                 }
                 {                         => 非受保护区
                     "Empty"
                 }
             }

3.4 ManagementPacket

• Request

  ManagementRequestPacket = 1 TLV-LENGTH
               { InterestIdentifier }        => 标识区
               { Signature }                 => 签名区
  

• Response

  ManagementResponsePacket = 1 TLV-LENGTH
               { DataIdentifier }            => 标识区
               { Signature }                 => 签名区
               {                             => 只读区
                   <Payload>
               }
               {                             => 可变区
                   {                         => 受保护区
                       "Empty"
                   }
                   {                         => 非受保护区
                       "Empty"
                   }
               }
  

  • SliceNumber

    SliceNumber = 205 TLV-LENGTH NoNegativeInteger
    

  • SliceSize

    SliceSize = 205 TLV-LENGTH NoNegativeInteger
    

4. Signature

Signature = SignatureInfo SignatureValue

SignatureInfo = 201 TLV-LENGTH
                <SignatureType>
                [KeyLocator]

SignatureValue = 200 TLV-LENGTH *OCTET

在MIN的包格式里面，一个签名 Signature 由两个连续的TLV块，SignatureInfo 和 SignatureValue 组成。

• SignatureInfo

SignatureInfo 中包含一个必选的子 TLV 块 SignatureType，它包含了签名的信息，其格式如下：

SignatureType = SIGNATURE-TYPE-TYPE TLV-LENGTH <NonNegativeInteger>

目前定义的 SignatureType的值如下：

SignatureType Value	Description
0	SM2_WITH_SM3，在SM3 Hash摘要的基础上用SM2签名进行完整性和不可否任性保护

SignatureInfo 中还包含一个可选的TLV块 KeyLocator （虽说是可选，但是这个是为了后期扩展，目前为必选项），它指示了用于签名的证书或者公钥的位置，其格式如下：

KeyLocator = KEYLOCATOR-TYPE TLV-TYPE <Identifier>

• SignatureValue

  SignatureValue 中包含了签名的值，是一串字节