1. Oracle Blockchain Platform Digital Assets Edition
  2. 区块链应用构建器增强功能
  3. 审计员角色

审计员角色

区块链应用程序构建器的增强版本包括在使用扩展的令牌分类框架标准时支持审计者角色。

随 Oracle Blockchain Platform Digital Assets Edition 提供的区块链应用程序构建器版本支持使用扩展标记分类框架标准的链代码项目另外两个角色。新角色为 Token Auditor 和 Org Auditor。这些角色的功能与 Token Admin 和 Org Admin 角色类似，但审计者角色仅限于只读访问权限。管理员角色具有读写访问权限。

以下信息介绍了支持 TypeScript 和 Go 中审计者角色的控制器方法和 SDK 方法。

TypeScript 控制器方法

以下控制器方法支持审计员角色功能。
addTokenAuditor
此方法将用户添加为链代码的 Token Auditor。此方法只能由链代码的 Token Admin 调用。 
public async addTokenAuditor(org_id: string, user_id: string)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Token Auditor 添加的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "cd81f6c4c9e7c18ece357dbf5c139ef66ef2d6566be3b14de5f6d0a3fd4bb2f0",
        "payload": {
            "msg": "Successfully added Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20009",
        "blockNumber": 196
    }
}
removeTokenAuditor
此方法将用户删除为链代码的 Token Auditor。此方法只能由链代码的 Token Admin 调用。 
public async removeTokenAuditor(org_id: string, user_id: string)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Token Auditor 删除的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "a886a6040fbc76374a3c78c89ab0ffc9f7b8391cc5239b169bf3b878cf40c67b",
        "payload": {
            "msg": "Successfully removed Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 219
    }
}
getTokenAuditors
此方法返回链代码的所有 Token Auditors。此方法只能由链代码的 Token Admin 或 Token Auditor 调用。 
public async getTokenAuditors()
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "auditors": [
                {
                    "org_id": "CB",
                    "user_id": "auditor_user_cb"
                }
            ]
        },
        "encode": "JSON"
    }
}
addOrgAuditor
此方法将用户添加为链代码的 Org Auditor。此方法只能由链代码的 Token Admin 或 Org Admin 调用。 
public async addOrgAuditor(org_id: string, user_id: string)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Org Auditor 添加的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "44bbad35a1478cb714e32f7cfd551897868a203520aab9cea5771d3aadc1cf03",
        "payload": {
            "msg": "Successfully added Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20009",
        "blockNumber": 198
    }
}
removeOrgAuditor
此方法将用户删除为链代码的 Org Auditor。此方法只能由链代码的 Token Admin 或 Org Admin 调用。 
public async removeOrgAuditor(org_id: string, user_id: string)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Org Auditor 删除的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "c3bc720461004a53b37c68d4bb264858b88d980bc093a0a3ebb62a32974fb306",
        "payload": {
            "msg": "Successfully removed Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 221
    }
}
getOrgAuditors
此方法返回链代码的所有 Org Auditors。此方法只能由 Token Admin、Token Auditor、Org Admin 或 Org Auditor 调用。 
public async getOrgAuditors()
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "auditors": [
                {
                    "org_id": "FI1",
                    "user_id": "auditor_user_fi1"
                },
                {
                    "org_id": "FI2",
                    "user_id": "auditor_user_fi2"
                }
            ]
        },
        "encode": "JSON"
    }
}

Go 控制器方法

以下控制器方法支持审计员角色功能。
AddTokenAuditor
此方法将用户添加为链代码的 Token Auditor。此方法只能由链代码的 Token Admin 调用。 
func (t *Controller) AddTokenAuditor(org_id string, user_id string) (interface{}, error)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Token Auditor 添加的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "f0888dd52f39dfa669275cc8f35d0b47b37b8407d384493d16970fcbb377f937",
        "payload": {
            "msg": "Successfully added Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 268
    }
}
RemoveTokenAuditor
此方法将用户删除为链代码的 Token Auditor。此方法只能由链代码的 Token Admin 调用。 
func (t *Controller) RemoveTokenAuditor(org_id string, user_id string) (interface{}, error)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Token Auditor 删除的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "2f01f48eceaf2dff175f98b96a5bdd22c949f48fc5683ce86d6141cc4892aee3",
        "payload": {
            "msg": "Successfully removed Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 270
    }
}
GetTokenAuditors
此方法返回链代码的所有 Token Auditors。此方法只能由链代码的 Token Admin 或 Token Auditor 调用。 
func (t *Controller) GetTokenAuditors() (interface{}, error)
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "18eaa81b04d43db64f28287bab1cf6609e2a1d8ff84852ff73849ddb9a9dfba1",
        "payload": {
            "auditors": [
                {
                    "OrgId": "CB",
                    "UserId": "auditor_user_cb"
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 269
    }
}
AddOrgAuditor
此方法将用户添加为链代码的 Org Auditor。此方法只能由链代码的 Token Admin 或 Org Admin 调用。 
func (t *Controller) AddOrgAuditor(org_id string, user_id string) (interface{}, error)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Org Auditor 添加的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "3d5ec46003c68c6208d43c82894bd6da5c0b763339cc5212e09b71d39d0d80e2",
        "payload": {
            "msg": "Successfully added Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 271
    }
}
RemoveOrgAuditor
此方法将用户删除为链代码的 Org Auditor。此方法只能由链代码的 Token Admin 或 Org Admin 调用。 
func (t *Controller) RemoveOrgAuditor(org_id string, user_id string) (interface{}, error)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Org Auditor 删除的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "713a120641afbc4dfaeac73b82c9fd51df6fcfd7d4d9a82553d3c487bf11f530",
        "payload": {
            "msg": "Successfully removed Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 273
    }
}
GetOrgAuditors
此方法返回链代码的所有 Org Auditors。此方法只能由 Token Admin、Token Auditor、Org Admin 或 Org Auditor 调用。 
func (t *Controller) GetOrgAuditors() (interface{}, error)
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "07656bf434616d7a3d7fe4fb81dc80c8cc608991648adfd9f6f2f2b9f6ddf468",
        "payload": {
            "auditors": [
                {
                    "OrgId": "CB",
                    "UserId": "cb"
                },
                {
                    "OrgId": "CB",
                    "UserId": "issuer_user_cb"
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}

TypeScript SDK 方法

以下 SDK 方法支持审计员角色函数。
addTokenAuditor
此方法将用户添加为链代码的 Token Auditor。 
this.Ctx.Admin.addTokenAuditor(org_id, user_id)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Token Auditor 添加的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "cd81f6c4c9e7c18ece357dbf5c139ef66ef2d6566be3b14de5f6d0a3fd4bb2f0",
        "payload": {
            "msg": "Successfully added Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20009",
        "blockNumber": 196
    }
}
removeTokenAuditor
此方法将用户删除为链代码的 Token Auditor。 
this.Ctx.Admin.removeTokenAuditor(org_id, user_id)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Token Auditor 删除的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "a886a6040fbc76374a3c78c89ab0ffc9f7b8391cc5239b169bf3b878cf40c67b",
        "payload": {
            "msg": "Successfully removed Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 219
    }
}
getTokenAuditors
此方法返回链代码的所有 Token Auditors。 
this.Ctx.Admin.getAllTokenAuditors()
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "auditors": [
                {
                    "org_id": "CB",
                    "user_id": "auditor_user_cb"
                }
            ]
        },
        "encode": "JSON"
    }
}
addOrgAuditor
此方法将用户添加为链代码的 Org Auditor。 
this.Ctx.Admin.addOrgAuditor(org_id, user_id)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Org Auditor 添加的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "44bbad35a1478cb714e32f7cfd551897868a203520aab9cea5771d3aadc1cf03",
        "payload": {
            "msg": "Successfully added Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20009",
        "blockNumber": 198
    }
}
removeOrgAuditor
此方法将用户删除为链代码的 Org Auditor。 
this.Ctx.Admin.removeOrgAuditor(org_id, user_id)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Org Auditor 删除的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "c3bc720461004a53b37c68d4bb264858b88d980bc093a0a3ebb62a32974fb306",
        "payload": {
            "msg": "Successfully removed Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 221
    }
}
getOrgAuditors
此方法返回链代码的所有 Org Auditors。 
this.Ctx.Admin.getAllOrgAuditors()
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "auditors": [
                {
                    "org_id": "FI1",
                    "user_id": "auditor_user_fi1"
                },
                {
                    "org_id": "FI2",
                    "user_id": "auditor_user_fi2"
                }
            ]
        },
        "encode": "JSON"
    }
}

Go SDK 方法

以下控制器方法支持审计员角色功能。
AddTokenAuditor
此方法将用户添加为链代码的 Token Auditor。 
t.Ctx.Admin.AddTokenAuditor(org_id, user_id)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Token Auditor 添加的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "f0888dd52f39dfa669275cc8f35d0b47b37b8407d384493d16970fcbb377f937",
        "payload": {
            "msg": "Successfully added Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 268
    }
}
RemoveTokenAuditor
此方法将用户删除为链代码的 Token Auditor。 
t.Ctx.Admin.RemoveTokenAuditor(org_id, user_id)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Token Auditor 删除的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "2f01f48eceaf2dff175f98b96a5bdd22c949f48fc5683ce86d6141cc4892aee3",
        "payload": {
            "msg": "Successfully removed Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 270
    }
}
GetTokenAuditors
此方法返回链代码的所有 Token Auditors。 
t.Ctx.Admin.GetAllTokenAuditors()
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "18eaa81b04d43db64f28287bab1cf6609e2a1d8ff84852ff73849ddb9a9dfba1",
        "payload": {
            "auditors": [
                {
                    "OrgId": "CB",
                    "UserId": "auditor_user_cb"
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 269
    }
}
AddOrgAuditor
此方法将用户添加为链代码的 Org Auditor。 
t.Ctx.Admin.AddOrgAuditor(org_id, user_id)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Org Auditor 添加的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "3d5ec46003c68c6208d43c82894bd6da5c0b763339cc5212e09b71d39d0d80e2",
        "payload": {
            "msg": "Successfully added Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 271
    }
}
RemoveOrgAuditor
此方法将用户删除为链代码的 Org Auditor。 
t.Ctx.Admin.RemoveOrgAuditor(org_id, user_id)
参数：
  • org_id: string —当前组织中用户的成员服务提供商 (MSP) ID。
  • user_id: string- 用户的用户名或电子邮件 ID。
返回：
  • 成功时，将出现一条消息，其中包含作为链代码的 Org Auditor 删除的用户的详细信息。
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "713a120641afbc4dfaeac73b82c9fd51df6fcfd7d4d9a82553d3c487bf11f530",
        "payload": {
            "msg": "Successfully removed Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 273
    }
}
GetOrgAuditors
此方法返回链代码的所有 Org Auditors。 
t.Ctx.Admin.GetAllOrgAuditors()
返回值示例：
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "07656bf434616d7a3d7fe4fb81dc80c8cc608991648adfd9f6f2f2b9f6ddf468",
        "payload": {
            "auditors": [
                {
                    "OrgId": "CB",
                    "UserId": "cb"
                },
                {
                    "OrgId": "CB",
                    "UserId": "issuer_user_cb"
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}