變數替代字轉換的執行方式

Blockchain App Builder 會自動產生可用來轉換使用「記號分類架構」標準之有趣記號的方法。

記號轉換方法包含交換集區的概念。交換集區帳戶是由其他權杖帳戶提供資金。當您輸入記號時，可以指定將轉換的記號百分比轉移到交換集區帳戶。

變數替代字轉換處理

轉換記號的一般流程遵循下列步驟：

呼叫 InitializeExchangePoolUser 方法來初始化交換集區使用者。
呼叫 CreateExchangePoolAccounts 方法以建立交換集區帳戶。為您要轉換的每個有趣變數替代字類型建立交換集區帳戶。
呼叫 AddConversionRate 方法來設定您要轉換之每組記號的轉換率。
以下列其中一種方式為交換集區記號帳戶提供資金：
- 使用標準傳輸方法將記號轉移到交換集區記號帳戶。
- 調解記號時呼叫 MintWithFundingExchangePoolToken 方法，此記號可將某個百分比的調解記號轉移到交換集區帳戶。
呼叫 TokenConversion 方法，在兩個有趣的記號之間轉換。單一使用者可以在其兩個權杖帳戶之間轉換權杖，或一組使用者可以直接將權杖從一個帳戶轉換成另一個帳戶。
匯集集區使用者可以檢視匯集集區科目餘額與科目交易。
- 呼叫 GetAccount 方法，以檢視每個交換集區權杖帳戶的餘額。
- 呼叫 GetAccountTransactionHistory 和 GetAccountTransactionHistoryWithFilters 方法，以檢視每個交換集區記號帳戶的帳戶交易。

自動產生的權杖轉換方法

Blockchain App Builder 會自動產生可在不同類型的有趣記號之間轉換的方法。控制器方法必須是公用才能呼叫。公用方法名稱開頭為大寫字元。開頭為小寫字元的方法名稱是私密的。

InitializeExchangePoolUser

此方法會初始化交換集區使用者，這是一次性活動。鏈碼的 Token Admin 只能呼叫此方法。

func (t *Controller) InitializeExchangePoolUser(org_id string, user_id string) (interface{}, error) {
    auth, err := t.Ctx.Auth.CheckAuthorization("TokenConversion.InitializeExchangePoolUser", "TOKEN")
    if err != nil && !auth {
        return nil, fmt.Errorf("error in authorizing the caller  %s", err.Error())
    }
    return t.Ctx.TokenConvertor.InitializeExchangePoolUser(org_id, user_id)
}

參數：

org_id: string - 目前組織中使用者的成員服務提供者 (MSP) ID。
user_id: string - 使用者的使用者名稱或電子郵件 ID。

傳回值：

成功時，包含交換集區使用者明細的訊息。

傳回值範例：

{
    "AssetType": "oconversion",
    "ConvertorId": "bcb1f3b1442c625d3ce205660c5e717c5858a1fe1e12c325df799a851ceaa09b",
    "OrgId": "Org1MSP",
    "UserId": "exchangepooluser"
}

CreateExchangePoolAccounts

此方法會為指定的權杖 ID 陣列建立交換集區權杖帳戶。鏈碼的 Token Admin 只能呼叫此方法。

func (t *Controller) CreateExchangePoolAccounts(token_ids []string) (interface{}, error) {
    auth, err := t.Ctx.Auth.CheckAuthorization("TokenConversion.InitializeExchangePoolUser", "TOKEN")
    if err != nil && !auth {
        return nil, fmt.Errorf("error in authorizing the caller  %s", err.Error())
    }
    var tokens []interface{}
    for _, tokenId := range token_ids {
        token, err := t.getTokenObject(tokenId)
        if err != nil {
            return nil, fmt.Errorf("error in getting from_token asset details. Error: %s", err)
        }
        tokens = append(tokens, token.Interface())
    }
    return t.Ctx.TokenConvertor.CreateExchangePoolAccounts(tokens)
}

參數：

token_ids: string [] - 記號 ID 的陣列。您最多可以指定十個權杖 ID。

傳回值：

成功時，包含所建立交換集區帳戶明細的物件清單。

傳回值範例：

[
    {
        "AccountId": "oaccount~cc9d84f6d4a5976532493ef5200c9603e138adc35166ffd5fd1aad9c1647f034",
        "Status": "created",
        "TokenId": "USD"
    },
    {
        "AccountId": "oaccount~3d4933111ec8bd6cc1ebb43f2b2c390deb929cfa534f9c6ada8e63bac04a13c0",
        "Status": "created",
        "TokenId": "INR"
    }
]

AddConversionRate

此方法會為一組記號新增轉換率。權杖轉換率最多可指定 8 位小數位數。鏈碼的 Token Admin 只能呼叫此方法。

func (t *Controller) AddConversionRate(from_token_id string, to_token_id string, token_conversion_rate float64) (interface{}, error) {
    auth, err := t.Ctx.Auth.CheckAuthorization("TokenConversion.AddConversionRate", "TOKEN")
    if err != nil && !auth {
        return nil, fmt.Errorf("error in authorizing the caller  %s", err.Error())
    }
    return t.Ctx.TokenConvertor.AddConversionToken(from_token_id, to_token_id, token_conversion_rate)
}

參數：

from_token_id: string - 要轉換的記號 ID。
to_token_id: string - 要轉換成的記號 ID。
token_conversion_rate: float64 - 將 from_token_id 記號轉換成 to_token_id 記號的速率。

傳回值：

成功時，轉換率物件的 JSON 表示法。

傳回值範例：

{
    "AssetType": "oconversionRate",
    "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
    "FromTokenId": "USD",
    "ToTokenId": "INR",
    "ConversionRate": 10
}

GetConversionRate

此方法會取得一對記號的目前兌換率。鏈碼的 Token Admin、任何 Org Admin 以及任何記號帳戶擁有者都可以呼叫此方法。

func (t *Controller) GetConversionRate(from_token_id string, to_token_id string) (interface{}, error) {
    auth, err := t.Ctx.Auth.CheckAuthorization("TokenConversion.GetConversionRate", "TOKEN")
    if err != nil && !auth {
        return nil, fmt.Errorf("error in authorizing the caller  %s", err.Error())
    }
    conversionRateId, err := t.Ctx.TokenConversionRate.GetConversionRateId(from_token_id, to_token_id)
    if err != nil {
        return nil, fmt.Errorf("error in getting conversationRateId. Error: %s", err)
    }
    return t.Ctx.TokenConversionRate.Get(conversionRateId)
}

參數：

from_token_id: string - 要轉換的記號 ID。
to_token_id: string - 要轉換成的記號 ID。

傳回值：

成功時，轉換率物件的 JSON 表示法。

傳回值範例：

{
    "AssetType": "oconversionRate",
    "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
    "FromTokenId": "USD",
    "ToTokenId": "INR",
    "ConversionRate": 10
}

UpdateConversionRate

此方法會更新一對記號的目前兌換率。權杖轉換率最多可指定 8 位小數位數。鏈碼的 Token Admin 只能呼叫此方法。

func (t *Controller) UpdateConversionRate(from_token_id string, to_token_id string, token_conversion_rate float64) (interface{}, error) {
    auth, err := t.Ctx.Auth.CheckAuthorization("TokenConversion.UpdateConversionRate", "TOKEN")
    if err != nil && !auth {
        return nil, fmt.Errorf("error in authorizing the caller  %s", err.Error())
    }
    return t.Ctx.TokenConvertor.UpdateTokenConversionRate(from_token_id, to_token_id, token_conversion_rate)
}

參數：

from_token_id: string - 要轉換的記號 ID。
to_token_id: string - 要轉換成的記號 ID。
token_conversion_rate: float64 - 將 from_token_id 記號轉換成 to_token_id 記號的速率。

傳回值：

成功時，已更新兌換率物件的 JSON 表示法。

傳回值範例：

{
    "AssetType": "oconversionRate",
    "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
    "FromTokenId": "USD",
    "ToTokenId": "INR",
    "ConversionRate": 15
}

MintWithFundingExchangePool

此方法會根據指定的權杖 ID 和數量來提示呼叫者帳戶中的權杖。之後，就會將處於提示數量的權杖百分比轉移到交換集區權杖帳戶。

func (t *Controller) MintWithFundingExchangePool(token_id string, token_quantity float64, percentage_token_to_exchangePool float64) (interface{}, error) {
    token, err := t.getTokenObject(token_id)
    if err != nil {
        return nil, fmt.Errorf("error in getting from_token asset details. Error: %s", err)
    }
    return t.Ctx.TokenConvertor.MintWithFundingExchangePool(token.Interface(), token_quantity, percentage_token_to_exchangePool)
}

參數：

token_id: string - 要進行 mint 的記號 ID。
token_quantity: float64 - 要提示的記號總數。
percentage_token_to_exchange_pool: float64 - 要轉移至交換集區記號帳戶的提示記號百分比。

傳回值：

成功時，會出現一則訊息，指出匯兌共同資金的採礦與資金成功。

傳回值範例：

{
    "msg": "successfully minted 100 tokens to AccountId: 'oaccount~1c568151c4acbcd1bd265c766c677145760a61c47fc8a3ba681a4cfbe287f9c1' (OrgId: Org1MSP, User-Id: admin) and Successfully transfered 80 tokens to exchange pool account with AccountId: 'oaccount~3d4933111ec8bd6cc1ebb43f2b2c390deb929cfa534f9c6ada8e63bac04a13c0' (OrgId: Org1MSP, UserId: exchangepooluser) "
}

TokenConversion

此方法會將呼叫端帳戶的記號轉換成由 to_token_id、to_org_id 和 to_user_id 值指定的帳戶。鏈碼的 Token Admin 和任何記號帳戶擁有者都可以呼叫此方法。交換集區使用者無法呼叫此方法。

func (t *Controller) TokenConversion(from_token_id string, to_token_id string, to_org_id string, to_user_id string, token_quantity float64) (interface{}, error) {
    auth, err := t.Ctx.Auth.CheckAuthorization("TokenConversion.TokenConversion", "TOKEN")
    if err != nil && !auth {
        return nil, fmt.Errorf("error in authorizing the caller  %s", err.Error())
    }
    from_token, err := t.getTokenObject(from_token_id)
    if err != nil {
        return nil, fmt.Errorf("error in getting from_token asset details. Error: %s", err)
    }
    to_token, err := t.getTokenObject(to_token_id)
    if err != nil {
        return nil, fmt.Errorf("error in getting to_token asset details. error: %s", err)
    }
    return t.Ctx.TokenConvertor.TokenConversion(from_token.Interface(), to_token.Interface(), to_org_id, to_user_id, token_quantity)
}

參數：

from_token_id: string - 要轉換的記號 ID。
to_token_id: string - 要轉換成的記號 ID。
to_org_id: string - 目前組織中接收記號之使用者的成員服務提供者 (MSP) ID。
to_user_id: string - 接收記號之使用者的使用者名稱或電子郵件 ID。
token_quantity: float64 - 要傳輸的記號總數。

傳回值：

成功時，表示權杖轉換成功的訊息。

傳回值範例：

{
    "msg": "succesfully converted 5 of tokens with tokenId: [USD] from AccountId: 'oaccount~abc74791148b761352b98df58035601b6f5480448ac2b4a3a7eb54bdbebf48eb' (OrgId: Org1MSP, UserId: admin) to 75 of tokens with tokenId: [INR] to AccountId: 'oaccount~25e2e66718b6dbb59aea9c32acebec60e09d912b2578d4933d377ae5d0628f1e' ( OrgId: Org1MSP, UserId: user ) as per the conversion rate of 15"
}

GetConversionHistory

此方法會傳回指定記號帳戶的記號轉換歷史記錄。鏈碼的 Token Admin、指定組織的 Org Admin 以及權杖帳戶擁有者可以呼叫此方法。

func (t *Controller) GetConversionHistory(token_id string, org_id string, user_id string) (interface{}, error) {
    auth, err := t.Ctx.Auth.CheckAuthorization("TokenConversion.GetConversionHistory", "TOKEN")
    if err != nil && !auth {
        return nil, fmt.Errorf("error in authorizing the caller  %s", err.Error())
    }
    account_id, err := t.Ctx.Account.GenerateAccountId(token_id, org_id, user_id)
    if err != nil {
        return nil, fmt.Errorf("error in generating the accoint_id. Error: %s", err)
    }
    return t.Ctx.Account.GetTokenConversionHistory(account_id, org_id, user_id)
}

參數：

token_id: string - 記號的 ID。
org_id: string - 目前組織中使用者的成員服務提供者 (MSP) ID。
user_id: string - 使用者的使用者名稱或電子郵件 ID。

傳回值：

成功時，包含轉換歷史記錄明細的 JSON 物件。

傳回值範例：

[
    {
        "balance": 95,
        "conversion_rate": 15,
        "converted_amount": 75,
        "from_account_id": "oaccount~abc74791148b761352b98df58035601b6f5480448ac2b4a3a7eb54bdbebf48eb",
        "from_token_id": "USD",
        "onhold_balance": 0,
        "timestamp": "2022-12-01T00:54:33+05:30",
        "to_account_id": "oaccount~25e2e66718b6dbb59aea9c32acebec60e09d912b2578d4933d377ae5d0628f1e",
        "to_token_id": "INR",
        "transacted_amount": 5,
        "transaction_id": "otransaction~e1f5c32ab3cdc17a51ff0edda6bcc71b5acec3320a69f68a4ae455ed416657fa",
        "transaction_type": "TOKEN_CONVERSION_DEBIT"
    }
]

GetConversionRateHistory

此方法會傳回一對記號的記號轉換率歷史記錄。鏈碼的 Token Admin、任何 Org Admin 以及任何記號帳戶擁有者都可以呼叫此方法。

func (t *Controller) GetConversionRateHistory(from_token_id string, to_token_id string) (interface{}, error) {
    auth, err := t.Ctx.Auth.CheckAuthorization("TokenConversion.GetConversionRateHistory", "TOKEN")
    if err != nil && !auth {
        return nil, fmt.Errorf("error in authorizing the caller  %s", err.Error())
    }
    conversion_rate_id, err := t.Ctx.TokenConversionRate.GetConversionRateId(from_token_id, to_token_id)
    if err != nil {
        return nil, fmt.Errorf("error in getting conversionRateId. Error: %s", err)
    }
    return t.Ctx.TokenConversionRate.History(conversion_rate_id)
}

參數：

from_token_id: string - 用於計算兌換率的變數替代字 ID。
to_token_id: string - 用於計算兌換率的變數替代字 ID。

傳回值：

成功時，包含兌換率歷史記錄明細的 JSON 物件。

傳回值範例：

[
  {
    "IsDelete": "false",
    "Timestamp": "2022-12-01T00:48:58+05:30",
    "TxId": "d6c5332278d33beddbc48e535029af424fef2129bf49f4906f9b527e101d95f1",
    "Value": {
      "AssetType": "oconversionRate",
      "ConversionRate": 15,
      "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
      "FromTokenId": "USD",
      "ToTokenId": "INR"
    }
  },
  {
    "IsDelete": "false",
    "Timestamp": "2022-12-01T00:47:15+05:30",
    "TxId": "e8796578351e948827d5dfe242ab4be59019ae67d69d3bfd6db255a268d57017",
    "Value": {
      "AssetType": "oconversionRate",
      "ConversionRate": 10,
      "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
      "FromTokenId": "USD",
      "ToTokenId": "INR"
    }
  }
]

GetExchangePoolUser

此方法會傳回交換集區使用者的 org_id 和 user_id 值。鏈碼的 Token Admin 只能呼叫此方法。

func (t *Controller) GetExchangePoolUser() (interface{}, error) {
    auth, err := t.Ctx.Auth.CheckAuthorization("TokenConversion.GetExchangePoolUser", "TOKEN")
    if err != nil && !auth {
        return nil, fmt.Errorf("error in authorizing the caller  %s", err.Error())
    }
    return t.Ctx.TokenConvertor.GetExchangePoolUser()
}

參數：

傳回值：

成功時，包含交換集區使用者相關資訊的訊息。

傳回值範例：

{
    "AssetType": "oconversion",
    "ConvertorId": "bcb1f3b1442c625d3ce205660c5e717c5858a1fe1e12c325df799a851ceaa09b",
    "OrgId": "Org1MSP",
    "UserId": "exchangepooluser"
}

權杖轉換 SDK 方法

InitializeExchangePoolUser

此方法會初始化交換集區使用者，這是一次性活動。鏈碼的 Token Admin 只能呼叫此方法。

Ctx.TokenConvertor.InitializeExchangePoolUser(org_id string, user_id string) (interface{}, error)

參數：

org_id: string - 目前組織中使用者的成員服務提供者 (MSP) ID。
user_id: string - 使用者的使用者名稱或電子郵件 ID。

傳回值：

成功時，包含交換集區使用者明細的訊息。

傳回值範例：

{
    "AssetType": "oconversion",
    "ConvertorId": "bcb1f3b1442c625d3ce205660c5e717c5858a1fe1e12c325df799a851ceaa09b",
    "OrgId": "Org1MSP",
    "UserId": "exchangepooluser"
}

CreateExchangePoolAccounts

此方法會為指定的權杖 ID 陣列建立交換集區權杖帳戶。鏈碼的 Token Admin 只能呼叫此方法。

Ctx.TokenConvertor.CreateExchangePoolAccounts(tokens []interface{}) (interface{}, error)

參數：

token_ids: string [] - 記號 ID 的陣列。

傳回值：

成功時，包含所建立交換集區帳戶明細的物件清單。

傳回值範例：

[
    {
        "AccountId": "oaccount~cc9d84f6d4a5976532493ef5200c9603e138adc35166ffd5fd1aad9c1647f034",
        "Status": "created",
        "TokenId": "USD"
    },
    {
        "AccountId": "oaccount~3d4933111ec8bd6cc1ebb43f2b2c390deb929cfa534f9c6ada8e63bac04a13c0",
        "Status": "created",
        "TokenId": "INR"
    }
]

AddConversionToken

此方法會為指定的記號新增具有新轉換率的記號。權杖轉換率最多可指定 8 位小數位數。鏈碼的 Token Admin 只能呼叫此方法。

Ctx.TokenConvertor.AddConversionToken(from_token_id string, to_token_id string, token_conversion_rate float64) (interface{}, error)

參數：

from_token_id: string - 要轉換的記號 ID。
to_token_id: string - 要轉換成的記號 ID。
token_conversion_rate: float64 - 將 from_token_id 記號轉換成 to_token_id 記號的速率。

傳回值：

成功時，轉換率物件的 JSON 表示法。

傳回值範例：

{
    "AssetType": "oconversionRate",
    "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
    "FromTokenId": "USD",
    "ToTokenId": "INR",
    "ConversionRate": 10
}

Get

此方法會取得一對記號的目前兌換率。鏈碼的 Token Admin 和任何記號帳戶擁有者都可以呼叫此方法。

Ctx.TokenConversionRate.Get(id string) (ConversionRate, error)

參數：

id: string - 權杖轉換率物件的 ID。

傳回值：

成功時，轉換率物件的 JSON 表示法。

傳回值範例：

{
    "AssetType": "oconversionRate",
    "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
    "FromTokenId": "USD",
    "ToTokenId": "INR",
    "ConversionRate": 10
}

UpdateTokenConversionRate

此方法會更新一對記號的目前兌換率。權杖轉換率最多可指定 8 位小數位數。鏈碼的 Token Admin 只能呼叫此方法。

Ctx.TokenConvertor.UpdateTokenConversionRate(from_token_id string, to_token_id string, token_conversion_rate float64) (interface{}, error)

參數：

from_token_id: string - 要轉換的記號 ID。
to_token_id: string - 要轉換成的記號 ID。
token_conversion_rate: float64 - 將 from_token_id 記號轉換成 to_token_id 記號的速率。

傳回值：

成功時，已更新兌換率物件的 JSON 表示法。

傳回值範例：

{
    "AssetType": "oconversionRate",
    "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
    "FromTokenId": "USD",
    "ToTokenId": "INR",
    "ConversionRate": 15
}

MintWithFundingExchangePool

此方法會根據指定的權杖 ID 和數量來提示呼叫者帳戶中的權杖。之後，就會將處於提示數量的權杖百分比轉移到交換集區權杖帳戶。

Ctx.TokenConvertor.MintWithFundingExchangePool(token interface{}, token_quantity float64, percentage_token_to_exchangePool float64) (interface{}, error)

參數：

token_id: string - 要進行 mint 的記號 ID。
token_quantity: float64 - 要提示的記號總數。
percentage_token_to_exchange_pool: float64 - 要轉移至交換集區記號帳戶的提示記號百分比。

傳回值：

成功時，會出現一則訊息，指出匯兌共同資金的採礦與資金成功。

傳回值範例：

{
    "msg": "successfully minted 100 tokens to AccountId: 'oaccount~1c568151c4acbcd1bd265c766c677145760a61c47fc8a3ba681a4cfbe287f9c1' (OrgId: Org1MSP, User-Id: admin) and Successfully transfered 80 tokens to exchange pool account with AccountId: 'oaccount~3d4933111ec8bd6cc1ebb43f2b2c390deb929cfa534f9c6ada8e63bac04a13c0' (OrgId: Org1MSP, UserId: exchangepooluser) "
}

TokenConversion

Ctx.TokenConvertor.TokenConversion(from_token interface{}, to_token interface{}, to_org_id string, to_user_id string, token_quantity float64) (interface{}, error)

參數：

from_token_id: string - 要轉換的記號 ID。
to_token_id: string - 要轉換成的記號 ID。
to_org_id: string - 目前組織中接收記號之使用者的成員服務提供者 (MSP) ID。
to_user_id: string - 接收記號之使用者的使用者名稱或電子郵件 ID。

傳回值：

成功時，表示權杖轉換成功的訊息。

傳回值範例：

{
    "msg": "succesfully converted 5 of tokens with tokenId: [USD] from AccountId: 'oaccount~abc74791148b761352b98df58035601b6f5480448ac2b4a3a7eb54bdbebf48eb' (OrgId: Org1MSP, UserId: admin) to 75 of tokens with tokenId: [INR] to AccountId: 'oaccount~25e2e66718b6dbb59aea9c32acebec60e09d912b2578d4933d377ae5d0628f1e' ( OrgId: Org1MSP, UserId: user ) as per the conversion rate of 15"
}

GetTokenConversionHistory

此方法會傳回指定記號帳戶的記號轉換歷史記錄。鏈碼的 Token Admin 和記號帳戶擁有者可以呼叫此方法。

Ctx.Account.GetTokenConversionHistory(account_id string, org_id string, user_id string) (interface{}, error)

參數：

account_id: string - 有趣記號帳戶的 ID。
org_id: string - 目前組織中使用者的成員服務提供者 (MSP) ID。
user_id: string - 使用者的使用者名稱或電子郵件 ID。

傳回值：

成功時，包含轉換歷史記錄明細的 JSON 物件。

傳回值範例：

[
    {
        "balance": 95,
        "conversion_rate": 15,
        "converted_amount": 75,
        "from_account_id": "oaccount~abc74791148b761352b98df58035601b6f5480448ac2b4a3a7eb54bdbebf48eb",
        "from_token_id": "USD",
        "onhold_balance": 0,
        "timestamp": "2022-12-01T00:54:33+05:30",
        "to_account_id": "oaccount~25e2e66718b6dbb59aea9c32acebec60e09d912b2578d4933d377ae5d0628f1e",
        "to_token_id": "INR",
        "transacted_amount": 5,
        "transaction_id": "otransaction~e1f5c32ab3cdc17a51ff0edda6bcc71b5acec3320a69f68a4ae455ed416657fa",
        "transaction_type": "TOKEN_CONVERSION_DEBIT"
    }
]

history

此方法會傳回一對記號的記號轉換率歷史記錄。鏈碼的 Token Admin、任何 Org Admin 以及任何記號帳戶擁有者都可以呼叫此方法。

Ctx.TokenConversionRate.History(conversion_rate_id string) (interface{}, error)

參數：

conversion_rate_id: string - 兌換率物件的 ID。

傳回值：

成功時，包含兌換率歷史記錄明細的 JSON 物件。

傳回值範例：

[
  {
    "IsDelete": "false",
    "Timestamp": "2022-12-01T00:48:58+05:30",
    "TxId": "d6c5332278d33beddbc48e535029af424fef2129bf49f4906f9b527e101d95f1",
    "Value": {
      "AssetType": "oconversionRate",
      "ConversionRate": 15,
      "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
      "FromTokenId": "USD",
      "ToTokenId": "INR"
    }
  },
  {
    "IsDelete": "false",
    "Timestamp": "2022-12-01T00:47:15+05:30",
    "TxId": "e8796578351e948827d5dfe242ab4be59019ae67d69d3bfd6db255a268d57017",
    "Value": {
      "AssetType": "oconversionRate",
      "ConversionRate": 10,
      "ConvertorRateId": "oconversionRate~79eacc670928bbc4c9ba4ebee135c8b4d6411af3110f8a9b782c383d5e18b150",
      "FromTokenId": "USD",
      "ToTokenId": "INR"
    }
  }
]

GetExchangePoolUser

此方法會傳回交換集區使用者的 org_id 和 user_id 值。鏈碼的 Token Admin 只能呼叫此方法。

Ctx.TokenConvertor.GetExchangePoolUser()

參數：

傳回值：

成功時，包含交換集區使用者相關資訊的訊息。

傳回值範例：

{
    "AssetType": "oconversion",
    "ConvertorId": "bcb1f3b1442c625d3ce205660c5e717c5858a1fe1e12c325df799a851ceaa09b",
    "OrgId": "Org1MSP",
    "UserId": "exchangepooluser"
}