tapyrus-api-client 0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/Gemfile +9 -0
- data/Gemfile.lock +68 -0
- data/README.md +183 -0
- data/Rakefile +10 -0
- data/docs/AddTimestampRequest.md +20 -0
- data/docs/AddressApi.md +142 -0
- data/docs/CreateUserRequest.md +24 -0
- data/docs/GetAddressesResponse.md +20 -0
- data/docs/GetTokensResponse.md +20 -0
- data/docs/IssueTokenRequest.md +20 -0
- data/docs/PaymentApi.md +76 -0
- data/docs/PaymentRequest.md +22 -0
- data/docs/PaymentResponse.md +18 -0
- data/docs/ReissueTokenRequest.md +18 -0
- data/docs/TimestampApi.md +139 -0
- data/docs/TokenApi.md +355 -0
- data/docs/TokenResponse.md +20 -0
- data/docs/TransferTokenRequest.md +20 -0
- data/docs/UserApi.md +140 -0
- data/docs/UserinfoResponse.md +22 -0
- data/docs/UserinfoResponseBalances.md +18 -0
- data/git_push.sh +58 -0
- data/lib/tapyrus-api-client.rb +56 -0
- data/lib/tapyrus-api-client/api/address_api.rb +142 -0
- data/lib/tapyrus-api-client/api/payment_api.rb +83 -0
- data/lib/tapyrus-api-client/api/timestamp_api.rb +138 -0
- data/lib/tapyrus-api-client/api/token_api.rb +345 -0
- data/lib/tapyrus-api-client/api/user_api.rb +145 -0
- data/lib/tapyrus-api-client/api_client.rb +389 -0
- data/lib/tapyrus-api-client/api_error.rb +57 -0
- data/lib/tapyrus-api-client/configuration.rb +270 -0
- data/lib/tapyrus-api-client/models/add_timestamp_request.rb +232 -0
- data/lib/tapyrus-api-client/models/create_user_request.rb +269 -0
- data/lib/tapyrus-api-client/models/get_addresses_response.rb +229 -0
- data/lib/tapyrus-api-client/models/get_tokens_response.rb +227 -0
- data/lib/tapyrus-api-client/models/issue_token_request.rb +232 -0
- data/lib/tapyrus-api-client/models/payment_request.rb +246 -0
- data/lib/tapyrus-api-client/models/payment_response.rb +218 -0
- data/lib/tapyrus-api-client/models/reissue_token_request.rb +223 -0
- data/lib/tapyrus-api-client/models/token_response.rb +227 -0
- data/lib/tapyrus-api-client/models/transfer_token_request.rb +232 -0
- data/lib/tapyrus-api-client/models/userinfo_response.rb +238 -0
- data/lib/tapyrus-api-client/models/userinfo_response_balances.rb +218 -0
- data/lib/tapyrus-api-client/version.rb +15 -0
- data/spec/api/address_api_spec.rb +59 -0
- data/spec/api/payment_api_spec.rb +47 -0
- data/spec/api/timestamp_api_spec.rb +58 -0
- data/spec/api/token_api_spec.rb +98 -0
- data/spec/api/user_api_spec.rb +59 -0
- data/spec/api_client_spec.rb +226 -0
- data/spec/configuration_spec.rb +42 -0
- data/spec/models/add_timestamp_request_spec.rb +40 -0
- data/spec/models/create_user_request_spec.rb +52 -0
- data/spec/models/get_addresses_response_spec.rb +40 -0
- data/spec/models/get_tokens_response_spec.rb +40 -0
- data/spec/models/issue_token_request_spec.rb +40 -0
- data/spec/models/payment_request_spec.rb +46 -0
- data/spec/models/payment_response_spec.rb +34 -0
- data/spec/models/reissue_token_request_spec.rb +34 -0
- data/spec/models/token_response_spec.rb +40 -0
- data/spec/models/transfer_token_request_spec.rb +40 -0
- data/spec/models/userinfo_response_balances_spec.rb +34 -0
- data/spec/models/userinfo_response_spec.rb +46 -0
- data/spec/spec_helper.rb +111 -0
- data/tapyrus-api-client.gemspec +38 -0
- metadata +192 -0
@@ -0,0 +1,20 @@
|
|
1
|
+
# TapyrusApiClient::TokenResponse
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **tokens_id** | **String** | | [optional] |
|
8
|
+
| **txid** | **String** | | [optional] |
|
9
|
+
|
10
|
+
## Example
|
11
|
+
|
12
|
+
```ruby
|
13
|
+
require 'tapyrus-api-client'
|
14
|
+
|
15
|
+
instance = TapyrusApiClient::TokenResponse.new(
|
16
|
+
tokens_id: c3ec2fd806701a3f55808cbec3922c38dafaa3070c48c803e9043ee3642c660b46,
|
17
|
+
txid: 76077052e323a8445c398b690ed8b4b49c9b6e4d1e8e19ea0e7de7cead6f5fc8
|
18
|
+
)
|
19
|
+
```
|
20
|
+
|
@@ -0,0 +1,20 @@
|
|
1
|
+
# TapyrusApiClient::TransferTokenRequest
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **address** | **String** | | |
|
8
|
+
| **amount** | **Integer** | | [optional] |
|
9
|
+
|
10
|
+
## Example
|
11
|
+
|
12
|
+
```ruby
|
13
|
+
require 'tapyrus-api-client'
|
14
|
+
|
15
|
+
instance = TapyrusApiClient::TransferTokenRequest.new(
|
16
|
+
address: 1CY6TSSARn8rAFD9chCghX5B7j4PKR8S1a,
|
17
|
+
amount: 100
|
18
|
+
)
|
19
|
+
```
|
20
|
+
|
data/docs/UserApi.md
ADDED
@@ -0,0 +1,140 @@
|
|
1
|
+
# TapyrusApiClient::UserApi
|
2
|
+
|
3
|
+
All URIs are relative to *https://ap-01.tapyrus.chaintope.com/api/v1*
|
4
|
+
|
5
|
+
| Method | HTTP request | Description |
|
6
|
+
| ------ | ------------ | ----------- |
|
7
|
+
| [**create_user**](UserApi.md#create_user) | **POST** /users | ユーザを作成します。 |
|
8
|
+
| [**get_user_info**](UserApi.md#get_user_info) | **GET** /userinfo | ユーザの情報を返します。 |
|
9
|
+
|
10
|
+
|
11
|
+
## create_user
|
12
|
+
|
13
|
+
> create_user(create_user_request)
|
14
|
+
|
15
|
+
ユーザを作成します。
|
16
|
+
|
17
|
+
OpenID Connect を使った認証で得た id_token と access_token を Tapyrus API へ登録しユーザを作成します。すでにユーザが存在する場合は認証情報を更新します。
|
18
|
+
|
19
|
+
### Examples
|
20
|
+
|
21
|
+
```ruby
|
22
|
+
require 'time'
|
23
|
+
require 'tapyrus-api-client'
|
24
|
+
|
25
|
+
api_instance = TapyrusApiClient::UserApi.new
|
26
|
+
create_user_request = TapyrusApiClient::CreateUserRequest.new({id_token: 'eyJhbGciOiJSUzI1NiIsImtpZCI6IjFlOWdkazcifQ.ewogImlzcyI6ICJodHRwOi8vc2VydmVyLmV4YW1wbGUuY29tIiwKICJzdWIiOiAiMjQ4Mjg5NzYxMDAxIiwKICJhdWQiOiAiczZCaGRSa3F0MyIsCiAibm9uY2UiOiAibi0wUzZfV3pBMk1qIiwKICJleHAiOiAxMzExMjgxOTcwLAogImlhdCI6IDEzMTEyODA5NzAKfQ.ggW8hZ1EuVLuxNuuIJKX_V8a_OMXzR0EHR9R6jgdqrOOF4daGU96Sr_P6qJp6IcmD3HP99Obi1PRs-cwh3LO-p146waJ8IhehcwL7F09JdijmBqkvPeB2T9CJNqeGpe-gccMg4vfKjkM8FcGvnzZUN4_KSP0aAp1tOJ1zZwgjxqGByKHiOtX7TpdQyHE5lcMiKPXfEIQILVq0pc_E2DzL7emopWoaoZTF_m0_N0YzFC6g6EJbOEoRoSK5hoDalrcvRYLSrQAZZKflyuVCyixEoV9GfNQC3_osjzw2PAithfubEEBLuVVk4XUVrWOLrLl0nx7RkKU8NXNHq-rvKMzqg', issuer: 'https://server.example.com', client_id: 's6BhdRkqt3', access_token: 'SlAV32hkKG'}) # CreateUserRequest |
|
27
|
+
|
28
|
+
begin
|
29
|
+
# ユーザを作成します。
|
30
|
+
api_instance.create_user(create_user_request)
|
31
|
+
rescue TapyrusApiClient::ApiError => e
|
32
|
+
puts "Error when calling UserApi->create_user: #{e}"
|
33
|
+
end
|
34
|
+
```
|
35
|
+
|
36
|
+
#### Using the create_user_with_http_info variant
|
37
|
+
|
38
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
39
|
+
|
40
|
+
> <Array(nil, Integer, Hash)> create_user_with_http_info(create_user_request)
|
41
|
+
|
42
|
+
```ruby
|
43
|
+
begin
|
44
|
+
# ユーザを作成します。
|
45
|
+
data, status_code, headers = api_instance.create_user_with_http_info(create_user_request)
|
46
|
+
p status_code # => 2xx
|
47
|
+
p headers # => { ... }
|
48
|
+
p data # => nil
|
49
|
+
rescue TapyrusApiClient::ApiError => e
|
50
|
+
puts "Error when calling UserApi->create_user_with_http_info: #{e}"
|
51
|
+
end
|
52
|
+
```
|
53
|
+
|
54
|
+
### Parameters
|
55
|
+
|
56
|
+
| Name | Type | Description | Notes |
|
57
|
+
| ---- | ---- | ----------- | ----- |
|
58
|
+
| **create_user_request** | [**CreateUserRequest**](CreateUserRequest.md) | | |
|
59
|
+
|
60
|
+
### Return type
|
61
|
+
|
62
|
+
nil (empty response body)
|
63
|
+
|
64
|
+
### Authorization
|
65
|
+
|
66
|
+
No authorization required
|
67
|
+
|
68
|
+
### HTTP request headers
|
69
|
+
|
70
|
+
- **Content-Type**: application/json
|
71
|
+
- **Accept**: Not defined
|
72
|
+
|
73
|
+
|
74
|
+
## get_user_info
|
75
|
+
|
76
|
+
> <UserinfoResponse> get_user_info(opts)
|
77
|
+
|
78
|
+
ユーザの情報を返します。
|
79
|
+
|
80
|
+
ユーザの`id`,`balance`, `address`の情報を返します。
|
81
|
+
|
82
|
+
### Examples
|
83
|
+
|
84
|
+
```ruby
|
85
|
+
require 'time'
|
86
|
+
require 'tapyrus-api-client'
|
87
|
+
# setup authorization
|
88
|
+
TapyrusApiClient.configure do |config|end
|
89
|
+
|
90
|
+
api_instance = TapyrusApiClient::UserApi.new
|
91
|
+
opts = {
|
92
|
+
confirmation_only: true # Boolean | オプションで`confirmation_only`を設定でき、`true`の場合ブロックチェーン上で承認済みのtpc・トークンのみを取得し、`false`の場合未承認のtpc・トークンも含めて取得します。デフォルトは`true`です。
|
93
|
+
}
|
94
|
+
|
95
|
+
begin
|
96
|
+
# ユーザの情報を返します。
|
97
|
+
result = api_instance.get_user_info(opts)
|
98
|
+
p result
|
99
|
+
rescue TapyrusApiClient::ApiError => e
|
100
|
+
puts "Error when calling UserApi->get_user_info: #{e}"
|
101
|
+
end
|
102
|
+
```
|
103
|
+
|
104
|
+
#### Using the get_user_info_with_http_info variant
|
105
|
+
|
106
|
+
This returns an Array which contains the response data, status code and headers.
|
107
|
+
|
108
|
+
> <Array(<UserinfoResponse>, Integer, Hash)> get_user_info_with_http_info(opts)
|
109
|
+
|
110
|
+
```ruby
|
111
|
+
begin
|
112
|
+
# ユーザの情報を返します。
|
113
|
+
data, status_code, headers = api_instance.get_user_info_with_http_info(opts)
|
114
|
+
p status_code # => 2xx
|
115
|
+
p headers # => { ... }
|
116
|
+
p data # => <UserinfoResponse>
|
117
|
+
rescue TapyrusApiClient::ApiError => e
|
118
|
+
puts "Error when calling UserApi->get_user_info_with_http_info: #{e}"
|
119
|
+
end
|
120
|
+
```
|
121
|
+
|
122
|
+
### Parameters
|
123
|
+
|
124
|
+
| Name | Type | Description | Notes |
|
125
|
+
| ---- | ---- | ----------- | ----- |
|
126
|
+
| **confirmation_only** | **Boolean** | オプションで`confirmation_only`を設定でき、`true`の場合ブロックチェーン上で承認済みのtpc・トークンのみを取得し、`false`の場合未承認のtpc・トークンも含めて取得します。デフォルトは`true`です。 | [optional] |
|
127
|
+
|
128
|
+
### Return type
|
129
|
+
|
130
|
+
[**UserinfoResponse**](UserinfoResponse.md)
|
131
|
+
|
132
|
+
### Authorization
|
133
|
+
|
134
|
+
No authorization required
|
135
|
+
|
136
|
+
### HTTP request headers
|
137
|
+
|
138
|
+
- **Content-Type**: Not defined
|
139
|
+
- **Accept**: application/json
|
140
|
+
|
@@ -0,0 +1,22 @@
|
|
1
|
+
# TapyrusApiClient::UserinfoResponse
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **sub** | **Integer** | | [optional] |
|
8
|
+
| **balances** | [**UserinfoResponseBalances**](UserinfoResponseBalances.md) | | [optional] |
|
9
|
+
| **addresses** | **Array<String>** | | [optional] |
|
10
|
+
|
11
|
+
## Example
|
12
|
+
|
13
|
+
```ruby
|
14
|
+
require 'tapyrus-api-client'
|
15
|
+
|
16
|
+
instance = TapyrusApiClient::UserinfoResponse.new(
|
17
|
+
sub: 1,
|
18
|
+
balances: null,
|
19
|
+
addresses: null
|
20
|
+
)
|
21
|
+
```
|
22
|
+
|
@@ -0,0 +1,18 @@
|
|
1
|
+
# TapyrusApiClient::UserinfoResponseBalances
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **tpc** | **Integer** | | [optional] |
|
8
|
+
|
9
|
+
## Example
|
10
|
+
|
11
|
+
```ruby
|
12
|
+
require 'tapyrus-api-client'
|
13
|
+
|
14
|
+
instance = TapyrusApiClient::UserinfoResponseBalances.new(
|
15
|
+
tpc: 50000000000
|
16
|
+
)
|
17
|
+
```
|
18
|
+
|
data/git_push.sh
ADDED
@@ -0,0 +1,58 @@
|
|
1
|
+
#!/bin/sh
|
2
|
+
# ref: https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/
|
3
|
+
#
|
4
|
+
# Usage example: /bin/sh ./git_push.sh wing328 openapi-pestore-perl "minor update" "gitlab.com"
|
5
|
+
|
6
|
+
git_user_id=$1
|
7
|
+
git_repo_id=$2
|
8
|
+
release_note=$3
|
9
|
+
git_host=$4
|
10
|
+
|
11
|
+
if [ "$git_host" = "" ]; then
|
12
|
+
git_host="github.com"
|
13
|
+
echo "[INFO] No command line input provided. Set \$git_host to $git_host"
|
14
|
+
fi
|
15
|
+
|
16
|
+
if [ "$git_user_id" = "" ]; then
|
17
|
+
git_user_id="GIT_USER_ID"
|
18
|
+
echo "[INFO] No command line input provided. Set \$git_user_id to $git_user_id"
|
19
|
+
fi
|
20
|
+
|
21
|
+
if [ "$git_repo_id" = "" ]; then
|
22
|
+
git_repo_id="GIT_REPO_ID"
|
23
|
+
echo "[INFO] No command line input provided. Set \$git_repo_id to $git_repo_id"
|
24
|
+
fi
|
25
|
+
|
26
|
+
if [ "$release_note" = "" ]; then
|
27
|
+
release_note="Minor update"
|
28
|
+
echo "[INFO] No command line input provided. Set \$release_note to $release_note"
|
29
|
+
fi
|
30
|
+
|
31
|
+
# Initialize the local directory as a Git repository
|
32
|
+
git init
|
33
|
+
|
34
|
+
# Adds the files in the local repository and stages them for commit.
|
35
|
+
git add .
|
36
|
+
|
37
|
+
# Commits the tracked changes and prepares them to be pushed to a remote repository.
|
38
|
+
git commit -m "$release_note"
|
39
|
+
|
40
|
+
# Sets the new remote
|
41
|
+
git_remote=`git remote`
|
42
|
+
if [ "$git_remote" = "" ]; then # git remote not defined
|
43
|
+
|
44
|
+
if [ "$GIT_TOKEN" = "" ]; then
|
45
|
+
echo "[INFO] \$GIT_TOKEN (environment variable) is not set. Using the git credential in your environment."
|
46
|
+
git remote add origin https://${git_host}/${git_user_id}/${git_repo_id}.git
|
47
|
+
else
|
48
|
+
git remote add origin https://${git_user_id}:${GIT_TOKEN}@${git_host}/${git_user_id}/${git_repo_id}.git
|
49
|
+
fi
|
50
|
+
|
51
|
+
fi
|
52
|
+
|
53
|
+
git pull origin master
|
54
|
+
|
55
|
+
# Pushes (Forces) the changes in the local repository up to the remote repository
|
56
|
+
echo "Git pushing to https://${git_host}/${git_user_id}/${git_repo_id}.git"
|
57
|
+
git push origin master 2>&1 | grep -v 'To https'
|
58
|
+
|
@@ -0,0 +1,56 @@
|
|
1
|
+
=begin
|
2
|
+
#Tapyrus API
|
3
|
+
|
4
|
+
## イントロダクション これは chaintope 社が開発するブロックチェーン Tapyrus を使ったブロックチェーンに関係する機能を簡単に利用するための REST API です。 現在以下のユースケースをサポートしています。これは今後も拡張されていくことを予定しています。 * Payment: TPC(Tapyrus Coin) の送金 * Timestamp: 任意のデータをタイムスタンプとしてブロックチェーンに記録 * Token: 新しいトークンの発行、送金、焼却。NFTも利用可能 Tapyrus ブロックチェーンについては以下の情報を参照してください。 * [Chaintope のブロックチェーンプロトコル](https://www.chaintope.com/chaintope-blockchain-protocol/) * [chaintope/tapyrus-core - github](https://github.com/chaintope/tapyrus-core) ## Tapyrus API の利用法 Tapyrus API は REST API として提供されています。利用を開始するためには、Tapyrus API の `エンドポイント` に対して、 `認証` 済みの トークンを使いアクセスする必要があります。また、認証されたユーザはそれぞれが自身のウォレットを Tapyrus API 内部に持つことになります。 ウォレットではそのユーザの TPC やトークンといったアセットを管理するための鍵が管理され、アセットの移動などで利用されます。 ### Tapyrus API のエンドポイント エンドポイントは以下のフォーマットで作成され、 chaintope より提供されます。 `ap-01.tapyrus.chaintope.com` 例えば [testnet](https://testnet-explorer.tapyrus.dev.chaintope.com/blocks) では以下のようになります。 `testnet-api.tapyrus.chaintope.com` testnet は誰でも利用可能な動作の確認用のネットワークであり、予告なくリセットされる可能性があります。 利用に必要な TPC は [faucet](https://testnet-faucet.tapyrus.dev.chaintope.com) から取得できます。 * [faucet](https://testnet-faucet.tapyrus.dev.chaintope.com) ### OpenID Connect を使った認証 Tapyrus API では [OpenID Connect](https://openid.net/connect/) を使った認証をサポートします。この認証を利用するためには、 以下のステップを踏みます。 1. 利用する OpenID Provider(OP) を選択する 公開された OP から選択する方法と、自身で OP を構築する方法があります。独自のユーザデータベースがあり、そのユーザに Tapyrus API を利用させる場合は後者の自身で OP を構築する方法を選択することになります。 2. OAuth 2.0 Client Credential を入手する 多くの公開された OP では、アプリケーションを登録して Client Credential を入手する必要があります。手順は利用する OP に従ってください。 3. Access Token と ID Token を入手する OpenID Connect に沿った認証を行い、 token エンドポイントから ID Token を入手します。 4. Tapyrus API ユーザを作成する 入手した Access Token と ID Token を Tapyrus API の [createUser API](https://doc.api.tapyrus.chaintope.com/#operation/createUser) へ送り、 Tapyrus API のユーザを作成します。 コード例を後述の Getting Started ドキュメントで解説していますので、そちらを参照してください。 ## Tapyrus API ユーザとウォレットについて 認証により得たアクセストークンを使い、Tapyrus API ユーザを1つ作成する必要があります。 Tapyrus API の内部では、このユーザ1つにつき1つのウォレットが作成されます。 ウォレットではアセットの受け取りや、送付に必要な公開鍵と秘密鍵のペアが管理されており、同時にそれらのカギに紐づくアセットも管理されます。 そのため、認証を行ったユーザごとに独立したアセットの管理が可能になります。 # Getting Started Getting Started ドキュメントでは実際のコード例を交えながらより具体的な Tapyrus API の利用法を解説しています。 * [Getting Started - [Javascript] Tapyrus API を利用するウェブアプリケーションの開発を学ぶ](https://github.com/chaintope/tapyrus-api-client-examples/tree/main/javascript/GettingStarted-ja.md)
|
5
|
+
|
6
|
+
The version of the OpenAPI document: 1.0.0
|
7
|
+
|
8
|
+
Generated by: https://openapi-generator.tech
|
9
|
+
OpenAPI Generator version: 5.2.1-SNAPSHOT
|
10
|
+
|
11
|
+
=end
|
12
|
+
|
13
|
+
# Common files
|
14
|
+
require 'tapyrus-api-client/api_client'
|
15
|
+
require 'tapyrus-api-client/api_error'
|
16
|
+
require 'tapyrus-api-client/version'
|
17
|
+
require 'tapyrus-api-client/configuration'
|
18
|
+
|
19
|
+
# Models
|
20
|
+
require 'tapyrus-api-client/models/add_timestamp_request'
|
21
|
+
require 'tapyrus-api-client/models/create_user_request'
|
22
|
+
require 'tapyrus-api-client/models/get_addresses_response'
|
23
|
+
require 'tapyrus-api-client/models/get_tokens_response'
|
24
|
+
require 'tapyrus-api-client/models/issue_token_request'
|
25
|
+
require 'tapyrus-api-client/models/payment_request'
|
26
|
+
require 'tapyrus-api-client/models/payment_response'
|
27
|
+
require 'tapyrus-api-client/models/reissue_token_request'
|
28
|
+
require 'tapyrus-api-client/models/token_response'
|
29
|
+
require 'tapyrus-api-client/models/transfer_token_request'
|
30
|
+
require 'tapyrus-api-client/models/userinfo_response'
|
31
|
+
require 'tapyrus-api-client/models/userinfo_response_balances'
|
32
|
+
|
33
|
+
# APIs
|
34
|
+
require 'tapyrus-api-client/api/address_api'
|
35
|
+
require 'tapyrus-api-client/api/payment_api'
|
36
|
+
require 'tapyrus-api-client/api/timestamp_api'
|
37
|
+
require 'tapyrus-api-client/api/token_api'
|
38
|
+
require 'tapyrus-api-client/api/user_api'
|
39
|
+
|
40
|
+
module TapyrusApiClient
|
41
|
+
class << self
|
42
|
+
# Customize default settings for the SDK using block.
|
43
|
+
# TapyrusApiClient.configure do |config|
|
44
|
+
# config.username = "xxx"
|
45
|
+
# config.password = "xxx"
|
46
|
+
# end
|
47
|
+
# If no block given, return the default Configuration object.
|
48
|
+
def configure
|
49
|
+
if block_given?
|
50
|
+
yield(Configuration.default)
|
51
|
+
else
|
52
|
+
Configuration.default
|
53
|
+
end
|
54
|
+
end
|
55
|
+
end
|
56
|
+
end
|
@@ -0,0 +1,142 @@
|
|
1
|
+
=begin
|
2
|
+
#Tapyrus API
|
3
|
+
|
4
|
+
## イントロダクション これは chaintope 社が開発するブロックチェーン Tapyrus を使ったブロックチェーンに関係する機能を簡単に利用するための REST API です。 現在以下のユースケースをサポートしています。これは今後も拡張されていくことを予定しています。 * Payment: TPC(Tapyrus Coin) の送金 * Timestamp: 任意のデータをタイムスタンプとしてブロックチェーンに記録 * Token: 新しいトークンの発行、送金、焼却。NFTも利用可能 Tapyrus ブロックチェーンについては以下の情報を参照してください。 * [Chaintope のブロックチェーンプロトコル](https://www.chaintope.com/chaintope-blockchain-protocol/) * [chaintope/tapyrus-core - github](https://github.com/chaintope/tapyrus-core) ## Tapyrus API の利用法 Tapyrus API は REST API として提供されています。利用を開始するためには、Tapyrus API の `エンドポイント` に対して、 `認証` 済みの トークンを使いアクセスする必要があります。また、認証されたユーザはそれぞれが自身のウォレットを Tapyrus API 内部に持つことになります。 ウォレットではそのユーザの TPC やトークンといったアセットを管理するための鍵が管理され、アセットの移動などで利用されます。 ### Tapyrus API のエンドポイント エンドポイントは以下のフォーマットで作成され、 chaintope より提供されます。 `ap-01.tapyrus.chaintope.com` 例えば [testnet](https://testnet-explorer.tapyrus.dev.chaintope.com/blocks) では以下のようになります。 `testnet-api.tapyrus.chaintope.com` testnet は誰でも利用可能な動作の確認用のネットワークであり、予告なくリセットされる可能性があります。 利用に必要な TPC は [faucet](https://testnet-faucet.tapyrus.dev.chaintope.com) から取得できます。 * [faucet](https://testnet-faucet.tapyrus.dev.chaintope.com) ### OpenID Connect を使った認証 Tapyrus API では [OpenID Connect](https://openid.net/connect/) を使った認証をサポートします。この認証を利用するためには、 以下のステップを踏みます。 1. 利用する OpenID Provider(OP) を選択する 公開された OP から選択する方法と、自身で OP を構築する方法があります。独自のユーザデータベースがあり、そのユーザに Tapyrus API を利用させる場合は後者の自身で OP を構築する方法を選択することになります。 2. OAuth 2.0 Client Credential を入手する 多くの公開された OP では、アプリケーションを登録して Client Credential を入手する必要があります。手順は利用する OP に従ってください。 3. Access Token と ID Token を入手する OpenID Connect に沿った認証を行い、 token エンドポイントから ID Token を入手します。 4. Tapyrus API ユーザを作成する 入手した Access Token と ID Token を Tapyrus API の [createUser API](https://doc.api.tapyrus.chaintope.com/#operation/createUser) へ送り、 Tapyrus API のユーザを作成します。 コード例を後述の Getting Started ドキュメントで解説していますので、そちらを参照してください。 ## Tapyrus API ユーザとウォレットについて 認証により得たアクセストークンを使い、Tapyrus API ユーザを1つ作成する必要があります。 Tapyrus API の内部では、このユーザ1つにつき1つのウォレットが作成されます。 ウォレットではアセットの受け取りや、送付に必要な公開鍵と秘密鍵のペアが管理されており、同時にそれらのカギに紐づくアセットも管理されます。 そのため、認証を行ったユーザごとに独立したアセットの管理が可能になります。 # Getting Started Getting Started ドキュメントでは実際のコード例を交えながらより具体的な Tapyrus API の利用法を解説しています。 * [Getting Started - [Javascript] Tapyrus API を利用するウェブアプリケーションの開発を学ぶ](https://github.com/chaintope/tapyrus-api-client-examples/tree/main/javascript/GettingStarted-ja.md)
|
5
|
+
|
6
|
+
The version of the OpenAPI document: 1.0.0
|
7
|
+
|
8
|
+
Generated by: https://openapi-generator.tech
|
9
|
+
OpenAPI Generator version: 5.2.1-SNAPSHOT
|
10
|
+
|
11
|
+
=end
|
12
|
+
|
13
|
+
require 'cgi'
|
14
|
+
|
15
|
+
module TapyrusApiClient
|
16
|
+
class AddressApi
|
17
|
+
attr_accessor :api_client
|
18
|
+
|
19
|
+
def initialize(api_client = ApiClient.default)
|
20
|
+
@api_client = api_client
|
21
|
+
end
|
22
|
+
# アドレスを生成して返します。
|
23
|
+
# 受金用のアドレス生成して返します。
|
24
|
+
# @param [Hash] opts the optional parameters
|
25
|
+
# @return [String]
|
26
|
+
def create_address(opts = {})
|
27
|
+
data, _status_code, _headers = create_address_with_http_info(opts)
|
28
|
+
data
|
29
|
+
end
|
30
|
+
|
31
|
+
# アドレスを生成して返します。
|
32
|
+
# 受金用のアドレス生成して返します。
|
33
|
+
# @param [Hash] opts the optional parameters
|
34
|
+
# @return [Array<(String, Integer, Hash)>] String data, response status code and response headers
|
35
|
+
def create_address_with_http_info(opts = {})
|
36
|
+
if @api_client.config.debugging
|
37
|
+
@api_client.config.logger.debug 'Calling API: AddressApi.create_address ...'
|
38
|
+
end
|
39
|
+
# resource path
|
40
|
+
local_var_path = '/addresses'
|
41
|
+
|
42
|
+
# query parameters
|
43
|
+
query_params = opts[:query_params] || {}
|
44
|
+
|
45
|
+
# header parameters
|
46
|
+
header_params = opts[:header_params] || {}
|
47
|
+
# HTTP header 'Accept' (if needed)
|
48
|
+
header_params['Accept'] = @api_client.select_header_accept(['application/json'])
|
49
|
+
|
50
|
+
# form parameters
|
51
|
+
form_params = opts[:form_params] || {}
|
52
|
+
|
53
|
+
# http body (model)
|
54
|
+
post_body = opts[:debug_body]
|
55
|
+
|
56
|
+
# return_type
|
57
|
+
return_type = opts[:debug_return_type] || 'String'
|
58
|
+
|
59
|
+
# auth_names
|
60
|
+
auth_names = opts[:debug_auth_names] || []
|
61
|
+
|
62
|
+
new_options = opts.merge(
|
63
|
+
:operation => :"AddressApi.create_address",
|
64
|
+
:header_params => header_params,
|
65
|
+
:query_params => query_params,
|
66
|
+
:form_params => form_params,
|
67
|
+
:body => post_body,
|
68
|
+
:auth_names => auth_names,
|
69
|
+
:return_type => return_type
|
70
|
+
)
|
71
|
+
|
72
|
+
data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
|
73
|
+
if @api_client.config.debugging
|
74
|
+
@api_client.config.logger.debug "API called: AddressApi#create_address\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
|
75
|
+
end
|
76
|
+
return data, status_code, headers
|
77
|
+
end
|
78
|
+
|
79
|
+
# これまで生成したアドレスを一覧にして返します。
|
80
|
+
# これまで生成したアドレスを一覧にして返します。
|
81
|
+
# @param [Hash] opts the optional parameters
|
82
|
+
# @option opts [Integer] :per 1ページあたりの件数
|
83
|
+
# @option opts [Integer] :page ページ番号
|
84
|
+
# @return [GetAddressesResponse]
|
85
|
+
def get_addresses(opts = {})
|
86
|
+
data, _status_code, _headers = get_addresses_with_http_info(opts)
|
87
|
+
data
|
88
|
+
end
|
89
|
+
|
90
|
+
# これまで生成したアドレスを一覧にして返します。
|
91
|
+
# これまで生成したアドレスを一覧にして返します。
|
92
|
+
# @param [Hash] opts the optional parameters
|
93
|
+
# @option opts [Integer] :per 1ページあたりの件数
|
94
|
+
# @option opts [Integer] :page ページ番号
|
95
|
+
# @return [Array<(GetAddressesResponse, Integer, Hash)>] GetAddressesResponse data, response status code and response headers
|
96
|
+
def get_addresses_with_http_info(opts = {})
|
97
|
+
if @api_client.config.debugging
|
98
|
+
@api_client.config.logger.debug 'Calling API: AddressApi.get_addresses ...'
|
99
|
+
end
|
100
|
+
# resource path
|
101
|
+
local_var_path = '/addresses'
|
102
|
+
|
103
|
+
# query parameters
|
104
|
+
query_params = opts[:query_params] || {}
|
105
|
+
query_params[:'per'] = opts[:'per'] if !opts[:'per'].nil?
|
106
|
+
query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
|
107
|
+
|
108
|
+
# header parameters
|
109
|
+
header_params = opts[:header_params] || {}
|
110
|
+
# HTTP header 'Accept' (if needed)
|
111
|
+
header_params['Accept'] = @api_client.select_header_accept(['application/json'])
|
112
|
+
|
113
|
+
# form parameters
|
114
|
+
form_params = opts[:form_params] || {}
|
115
|
+
|
116
|
+
# http body (model)
|
117
|
+
post_body = opts[:debug_body]
|
118
|
+
|
119
|
+
# return_type
|
120
|
+
return_type = opts[:debug_return_type] || 'GetAddressesResponse'
|
121
|
+
|
122
|
+
# auth_names
|
123
|
+
auth_names = opts[:debug_auth_names] || []
|
124
|
+
|
125
|
+
new_options = opts.merge(
|
126
|
+
:operation => :"AddressApi.get_addresses",
|
127
|
+
:header_params => header_params,
|
128
|
+
:query_params => query_params,
|
129
|
+
:form_params => form_params,
|
130
|
+
:body => post_body,
|
131
|
+
:auth_names => auth_names,
|
132
|
+
:return_type => return_type
|
133
|
+
)
|
134
|
+
|
135
|
+
data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
|
136
|
+
if @api_client.config.debugging
|
137
|
+
@api_client.config.logger.debug "API called: AddressApi#get_addresses\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
|
138
|
+
end
|
139
|
+
return data, status_code, headers
|
140
|
+
end
|
141
|
+
end
|
142
|
+
end
|