@@ -47,7 +47,7 @@ an Account or sign the request.
47
47
- CLI 1: Is connected to the network of nodes. Doesn't have access to private keys.
48
48
- CLI 2: Stores private key. Does not have a connection to the network of nodes.
49
49
- Build transaction by CLI 1: ` dcld tx ... --generate-only `
50
- - Fetch ` account number ` and ` sequence ` by CLI 1: ` dcld query auth account --address <address> `
50
+ - Fetch ` account- number ` and ` sequence ` by CLI 1: ` dcld query auth account --address <address> `
51
51
- Sign transaction by CLI 2: ` dcld tx sign txn.json --from <from> --account-number <int> --sequence <int> --gas "auto" --offline --output-document txn.json `
52
52
- Broadcast transaction by CLI 1: ` dcld tx broadcast txn.json `
53
53
- To get the actual result of transaction, ` dcld query tx=txHash ` call must be executed, where ` txHash ` is the hash of previously executed transaction.
@@ -1356,16 +1356,16 @@ Should be sent to trusted nodes only.
1356
1356
1357
1357
### E2E (NOC)
1358
1358
1359
- #### ADD_NOC_ROOT
1359
+ #### ADD_NOC_ROOT (RCAC)
1360
1360
1361
1361
** Status: Implemented**
1362
1362
1363
- This transaction adds a NOC root certificate owned by the Vendor.
1363
+ This transaction adds a NOC root certificate (RCAC) owned by the Vendor.
1364
1364
1365
1365
- Who can send
1366
1366
- Vendor account
1367
1367
- Parameters:
1368
- - cert: ` string ` - The NOC Root Certificate, encoded in X.509v3 PEM format. Can be a PEM string or a file path.
1368
+ - cert: ` string ` - The NOC Root Certificate (RCAC) , encoded in X.509v3 PEM format. Can be a PEM string or a file path.
1369
1369
- schemaVersion: ` optional(uint16) ` - Certificate's schema version to support backward/forward compatability(default 0)
1370
1370
- In State:
1371
1371
- ` pki/ApprovedCertificates/value/<Subject>/<SubjectKeyID> `
@@ -1375,27 +1375,27 @@ This transaction adds a NOC root certificate owned by the Vendor.
1375
1375
- CLI Command:
1376
1376
- ` dcld tx pki add-noc-x509-root-cert --certificate=<string-or-path> --from=<account> `
1377
1377
- Validation:
1378
- - the provided certificate must be a root certificate:
1378
+ - the provided certificate must be a root certificate (RCAC) :
1379
1379
- ` Issuer ` == ` Subject `
1380
1380
- ` Authority Key Identifier ` == ` Subject Key Identifier `
1381
1381
- no existing certificate with the same ` <Certificate's Issuer>:<Certificate's Serial Number> ` combination.
1382
1382
- if certificates with the same ` <Certificate's Subject>:<Certificate's Subject Key ID> ` combination already exist:
1383
- - the existing certificate must be NOC root certificate
1383
+ - the existing certificate must be NOC root certificate (RCAC)
1384
1384
- the sender's VID must match the ` vid ` field of the existing certificates.
1385
1385
- the signature (self-signature) and expiration date must be valid.
1386
1386
1387
- #### REVOKE_NOC_ROOT
1387
+ #### REVOKE_NOC_ROOT (RCAC)
1388
1388
1389
1389
** Status: Implemented**
1390
1390
1391
- This transaction revokes a NOC root certificate owned by the Vendor.
1392
- Revoked NOC root certificates can be re-added using the [ ADD_NOC_ROOT] ( #add_noc_root ) transaction.
1391
+ This transaction revokes a NOC root certificate (RCAC) owned by the Vendor.
1392
+ Revoked NOC root certificates (RCACs) can be re-added using the [ ADD_NOC_ROOT] ( #add_noc_root-(rcac) ) transaction.
1393
1393
1394
1394
Revocation works as a soft-delete, meaning that the certificates are not entirely removed but moved from the approved list to the revoked list.
1395
1395
Revoked certificates can be retrieved by using the [ GET_REVOKED_CERT] ( #get_revoked_cert ) query.
1396
1396
1397
1397
- Who can send: Vendor account
1398
- - Vid field associated with the corresponding NOC root certificate on the ledger must be equal to the Vendor account's VID.
1398
+ - Vid field associated with the corresponding NOC root certificate (RCAC) on the ledger must be equal to the Vendor account's VID.
1399
1399
- Parameters:
1400
1400
- subject: ` string ` - base64 encoded subject DER sequence bytes of the certificate.
1401
1401
- subject_key_id: ` string ` - certificate's ` Subject Key Id ` in hex string format, e.g., ` 5A:88:0E:6C:36:53:D0:7F:B0:89:71:A3:F4:73:79:09:30:E6:2B:DB ` .
@@ -1409,19 +1409,19 @@ Revoked certificates can be retrieved by using the [GET_REVOKED_CERT](#get_revok
1409
1409
- CLI command:
1410
1410
- ` dcld tx pki revoke-noc-x509-root-cert --subject=<base64 string> --subject-key-id=<hex string> --serial-number=<string> --info=<string> --time=<int64> --revoke-child=<bool> --from=<account> `
1411
1411
- Validation:
1412
- - a NOC Root Certificate with the provided ` subject ` and ` subject_key_id ` must exist in the ledger.
1412
+ - a NOC Root Certificate (RCAC) with the provided ` subject ` and ` subject_key_id ` must exist in the ledger.
1413
1413
1414
- #### REMOVE_NOC_ROOT
1414
+ #### REMOVE_NOC_ROOT (RCAC)
1415
1415
1416
1416
** Status: Implemented**
1417
1417
1418
- This transaction completely removes the given NOC root certificate owned by the Vendor from the ledger.
1419
- Removed NOC root certificates can be re-added using the [ ADD_NOC_ROOT] ( #add_noc_root ) transaction.
1418
+ This transaction completely removes the given NOC root certificate (RCAC) owned by the Vendor from the ledger.
1419
+ Removed NOC root certificates (RCACs) can be re-added using the [ ADD_NOC_ROOT] ( #add_noc_root-(rcac) ) transaction.
1420
1420
1421
1421
- Who can send: Vendor account
1422
1422
- Vid field associated with the corresponding NOC certificate on the ledger must be equal to the Vendor account's VID.
1423
1423
- Validation:
1424
- - a NOC Root Certificate with the provided ` subject ` and ` subject_key_id ` must exist in the ledger.
1424
+ - a NOC Root Certificate (RCAC) with the provided ` subject ` and ` subject_key_id ` must exist in the ledger.
1425
1425
- Parameters:
1426
1426
- subject: ` string ` - base64 encoded subject DER sequence bytes of the certificate.
1427
1427
- subject_key_id: ` string ` - certificate's ` Subject Key Id ` in hex string format, e.g., ` 5A:88:0E:6C:36:53:D0:7F:B0:89:71:A3:F4:73:79:09:30:E6:2B:DB ` .
@@ -1431,11 +1431,11 @@ Removed NOC root certificates can be re-added using the [ADD_NOC_ROOT](#add_noc_
1431
1431
1432
1432
1433
1433
1434
- #### ADD_NOC_ICA
1434
+ #### ADD_NOC_ICA (ICAC)
1435
1435
1436
1436
** Status: Implemented**
1437
1437
1438
- This transaction adds a NOC ICA certificate owned by the Vendor signed by a chain of certificates which must be
1438
+ This transaction adds a NOC ICA certificate (ICAC) owned by the Vendor signed by a chain of certificates which must be
1439
1439
already present on the ledger.
1440
1440
1441
1441
- Who can send: Vendor account
@@ -1463,12 +1463,12 @@ already present on the ledger.
1463
1463
- CLI Command:
1464
1464
- ` dcld tx pki add-noc-x509-ica-cert --certificate=<string-or-path> --from=<account> `
1465
1465
1466
- #### REVOKE_NOC_ICA
1466
+ #### REVOKE_NOC_ICA (ICAC)
1467
1467
1468
1468
** Status: Implemented**
1469
1469
1470
- This transaction revokes a NOC ICA certificate owned by the Vendor.
1471
- Revoked NOC ICA certificates can be re-added using the [ ADD_NOC_ICA] ( #add_noc_ica ) transaction.
1470
+ This transaction revokes a NOC ICA certificate (ICAC) owned by the Vendor.
1471
+ Revoked NOC ICA certificates (ICACs) can be re-added using the [ ADD_NOC_ICA] ( #add_noc_ica-(icac) ) transaction.
1472
1472
1473
1473
Revocation works as a soft-delete, meaning that the certificates are not entirely removed but moved from the approved list to the revoked list.
1474
1474
Revoked certificates can be retrieved by using the [ GET_REVOKED_CERT] ( #get_revoked_cert ) query.
@@ -1489,17 +1489,17 @@ Revoked certificates can be retrieved by using the [GET_REVOKED_CERT](#get_revok
1489
1489
- CLI command:
1490
1490
- ` dcld tx pki revoke-noc-x509-ica-cert --subject=<base64 string> --subject-key-id=<hex string> --serial-number=<string> --info=<string> --time=<int64> --revoke-child=<bool> --from=<account> `
1491
1491
1492
- #### REMOVE_NOC_ICA
1492
+ #### REMOVE_NOC_ICA (ICAC)
1493
1493
1494
1494
** Status: Implemented**
1495
1495
1496
- This transaction completely removes the given NOC ICA owned by the Vendor from the ledger.
1497
- Removed NOC ICA certificates can be re-added using the [ ADD_NOC_ICA] ( #add_noc_ica ) transaction.
1496
+ This transaction completely removes the given NOC ICA (ICAC) owned by the Vendor from the ledger.
1497
+ Removed NOC ICA certificates (ICACs) can be re-added using the [ ADD_NOC_ICA] ( #add_noc_ica-(icac) ) transaction.
1498
1498
1499
1499
- Who can send: Vendor account
1500
1500
- Vid field associated with the corresponding NOC certificate on the ledger must be equal to the Vendor account's VID.
1501
1501
- Validation:
1502
- - a NOC ICA Certificate with the provided ` subject ` and ` subject_key_id ` must exist in the ledger.
1502
+ - a NOC ICA Certificate (ICAC) with the provided ` subject ` and ` subject_key_id ` must exist in the ledger.
1503
1503
- Parameters:
1504
1504
- subject: ` string ` - base64 encoded subject DER sequence bytes of the certificate.
1505
1505
- subject_key_id: ` string ` - certificate's ` Subject Key Id ` in hex string format, e.g., ` 5A:88:0E:6C:36:53:D0:7F:B0:89:71:A3:F4:73:79:09:30:E6:2B:DB ` .
@@ -1508,14 +1508,14 @@ Removed NOC ICA certificates can be re-added using the [ADD_NOC_ICA](#add_noc_ic
1508
1508
- ` dcld tx pki remove-noc-x509-ica-cert --subject=<base64 string> --subject-key-id=<hex string> --from=<account> `
1509
1509
1510
1510
1511
- #### GET_NOC_ROOT_BY_VID
1511
+ #### GET_NOC_ROOT_BY_VID (RCACs)
1512
1512
1513
1513
** Status: Implemented**
1514
1514
1515
- Retrieve NOC root certificates associated with a specific VID.
1515
+ Retrieve NOC root certificates (RCACs) associated with a specific VID.
1516
1516
1517
- Revoked NOC root certificates are not returned.
1518
- Use [ GET_ALL_REVOKED_NOC_ROOT] ( #get_revoked_noc_root ) to get a list of all revoked NOC root certificates.
1517
+ Revoked NOC root certificates (RCACs) are not returned.
1518
+ Use [ GET_ALL_REVOKED_NOC_ROOT] ( #get_all_revoked_noc_root-(rcacs) ) to get a list of all revoked NOC root certificates (RCACs) .
1519
1519
1520
1520
- Who can send: Any account
1521
1521
- Parameters:
@@ -1525,15 +1525,16 @@ Use [GET_ALL_REVOKED_NOC_ROOT](#get_revoked_noc_root) to get a list of all revok
1525
1525
- REST API:
1526
1526
- GET ` /dcl/pki/noc-root-certificates/{vid} `
1527
1527
1528
- #### GET_NOC_BY_VID_AND_SKID
1528
+ #### GET_NOC_BY_VID_AND_SKID (RCACs/ICACs)
1529
1529
1530
1530
** Status: Implemented**
1531
1531
1532
- Retrieve NOC (Root/ICA) certificates associated with a specific VID and subject key ID.
1532
+ Retrieve NOC (Root/ICA) certificates (RCACs/ICACs) associated with a specific VID and subject key ID.
1533
1533
This request also returns the Trust Quotient (TQ) value of the certificate
1534
1534
1535
1535
Revoked NOC certificates are not returned.
1536
- Use [ GET_ALL_REVOKED_NOC_ROOT] ( #get_revoked_noc_root ) to get a list of all revoked NOC root certificates.
1536
+ Use [ GET_ALL_REVOKED_NOC_ROOT] ( #get_all_revoked_noc_root-(rcacs) ) to get a list of all revoked NOC root certificates.
1537
+ Use [ GET_ALL_REVOKED_CERT] ( #get_all_revoked_certs ) to get a list of all revoked certificates (including ICACs).
1537
1538
1538
1539
- Who can send: Any account
1539
1540
- Parameters:
@@ -1544,11 +1545,11 @@ Use [GET_ALL_REVOKED_NOC_ROOT](#get_revoked_noc_root) to get a list of all revok
1544
1545
- REST API:
1545
1546
- GET ` /dcl/pki/noc-certificates/{vid}/{subject_key_id} `
1546
1547
1547
- #### GET_NOC_ICA_BY_VID
1548
+ #### GET_NOC_ICA_BY_VID (ICACs)
1548
1549
1549
1550
** Status: Implemented**
1550
1551
1551
- Retrieve NOC ICA certificates associated with a specific VID.
1552
+ Retrieve NOC ICA certificates (ICACs) associated with a specific VID.
1552
1553
1553
1554
Revoked certificates are not returned.
1554
1555
Use [ GET_ALL_REVOKED_CERT] ( #get_all_revoked_certs ) to get a list of all revoked certificates.
@@ -1561,11 +1562,11 @@ Use [GET_ALL_REVOKED_CERT](#get_all_revoked_certs) to get a list of all revoked
1561
1562
- REST API:
1562
1563
- GET ` /dcl/pki/noc-ica-certificates/{vid} `
1563
1564
1564
- #### GET_REVOKED_NOC_ROOT
1565
+ #### GET_REVOKED_NOC_ROOT (RCAC)
1565
1566
1566
1567
** Status: Implemented**
1567
1568
1568
- Gets a revoked NOC root certificate by the given subject and subject key ID attributes.
1569
+ Gets a revoked NOC root certificate (RCAC) by the given subject and subject key ID attributes.
1569
1570
1570
1571
Revocation works as a soft-delete, meaning that the certificates are not entirely removed but moved from the approved list to the revoked list.
1571
1572
@@ -1577,14 +1578,14 @@ Revocation works as a soft-delete, meaning that the certificates are not entirel
1577
1578
- REST API:
1578
1579
- GET ` /dcl/pki/revoked-noc-root-certificates/{subject}/{subject_key_id} `
1579
1580
1580
- #### GET_ALL_NOC_ROOT
1581
+ #### GET_ALL_NOC_ROOT (RCACs)
1581
1582
1582
1583
** Status: Implemented**
1583
1584
1584
- Retrieve a list of all of NOC root certificates.
1585
+ Retrieve a list of all of NOC root certificates (RCACs) .
1585
1586
1586
- Revoked NOC root certificates are not returned.
1587
- Use [ GET_ALL_REVOKED_NOC_ROOT] ( #get_revoked_noc_root ) to get a list of all revoked NOC root certificates.
1587
+ Revoked NOC root certificates (RCACs) are not returned.
1588
+ Use [ GET_ALL_REVOKED_NOC_ROOT] ( #get_all_revoked_noc_root-(rcacs) ) to get a list of all revoked NOC root certificates (RCACs) .
1588
1589
1589
1590
- Who can send: Any account
1590
1591
- Parameters:
@@ -1594,11 +1595,11 @@ Use [GET_ALL_REVOKED_NOC_ROOT](#get_revoked_noc_root) to get a list of all revok
1594
1595
- REST API:
1595
1596
- GET ` /dcl/pki/noc-root-certificates `
1596
1597
1597
- #### GET_ALL_NOC_ICA
1598
+ #### GET_ALL_NOC_ICA (ICACs)
1598
1599
1599
1600
** Status: Implemented**
1600
1601
1601
- Retrieve a list of all of NOC ICA certificates
1602
+ Retrieve a list of all of NOC ICA certificates (ICACs).
1602
1603
1603
1604
Revoked certificates are not returned.
1604
1605
Use [ GET_ALL_REVOKED_CERT] ( #get_all_revoked_certs ) to get a list of all revoked certificates.
@@ -1611,9 +1612,9 @@ Use [GET_ALL_REVOKED_CERT](#get_all_revoked_certs) to get a list of all revoked
1611
1612
- REST API:
1612
1613
- GET ` /dcl/pki/noc-ica-certificates `
1613
1614
1614
- #### GET_ALL_REVOKED_NOC_ROOT
1615
+ #### GET_ALL_REVOKED_NOC_ROOT (RCACs)
1615
1616
1616
- Gets all revoked NOC root certificates.
1617
+ Gets all revoked NOC root certificates (RCACs) .
1617
1618
1618
1619
Revocation works as a soft-delete, meaning that the certificates are not entirely removed but moved from the approved list to the revoked list.
1619
1620
0 commit comments