Skip to content

Commit

Permalink
deploy: 3e769de
Browse files Browse the repository at this point in the history
  • Loading branch information
@nguyer
nguyer committed Apr 25, 2024
1 parent d20d1f9 commit 5ac34e2
Show file tree
Hide file tree
Showing 3 changed files with 44 additions and 2 deletions.
4 changes: 2 additions & 2 deletions head/assets/js/search-data.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1753,7 +1753,7 @@
},"292": {
"doc": "ContractAPI",
"title": "ContractAPI",
"content": "Contract APIs provide generated REST APIs for on-chain smart contracts. API endpoints are generated to invoke or perform query operations against each of the functions/methods implemented by the smart contract. API endpoints are also provided to add listeners to the events of that smart contract. Note that once you have established listeners for your blockchain events into FireFly, you need to also subscribe in your application to receive the FireFly events (of type blockchain_event_received) that are emitted for each detected blockchain event. For more information see the Events reference section. URL . The base path for your Contract API is: . | /api/v1/namespaces/{ns}/apis/{apiName} | . For the default namespace, this can be shortened to: . | /api/v1/apis/{apiName} | . FireFly Interface (FFI) and On-chain Location . Contract APIs are registered against: . | A FireFly Interface (FFI) definition, which defines in a blockchain agnostic format the list of functions/events supported by the smart contract. Also detailed type information about the inputs/outputs to those functions/events. | An optional location configured on the Contract API describes where the instance of the smart contract the API should interact with exists in the blockchain layer. For example the address of the Smart Contract for an Ethereum based blockchain, or the name and channel for a Hyperledger Fabric based blockchain. | . If the location is not specified on creation of the Contract API, then it must be specified on each API call made to the Contract API endpoints. OpenAPI V3 / Swagger Definitions . Each Contract API comes with an OpenAPI V3 / Swagger generated definition, which can be downloaded from: . | /api/v1/namespaces/{namespaces}/apis/{apiName}/api/swagger.json | . Swagger UI . A browser / exerciser UI for your API is also available on: . | /api/v1/namespaces/{namespaces}/apis/{apiName}/api | . Example . { \"id\": \"0f12317b-85a0-4a77-a722-857ea2b0a5fa\", \"namespace\": \"ns1\", \"interface\": { \"id\": \"c35d3449-4f24-4676-8e64-91c9e46f06c4\" }, \"location\": { \"address\": \"0x95a6c4895c7806499ba35f75069198f45e88fc69\" }, \"name\": \"my_contract_api\", \"message\": \"b09d9f77-7b16-4760-a8d7-0e3c319b2a16\", \"urls\": { \"openapi\": \"http://127.0.0.1:5000/api/v1/namespaces/default/apis/my_contract_api/api/swagger.json\", \"ui\": \"http://127.0.0.1:5000/api/v1/namespaces/default/apis/my_contract_api/api\" }, \"published\": false } . Field Descriptions . | Field Name | Description | Type | . | id | The UUID of the contract API | UUID | . | namespace | The namespace of the contract API | string | . | interface | Reference to the FireFly Interface definition associated with the contract API | FFIReference | . | location | If this API is tied to an individual instance of a smart contract, this field can include a blockchain specific contract identifier. For example an Ethereum contract address, or a Fabric chaincode name and channel | JSONAny | . | name | The name that is used in the URL to access the API | string | . | networkName | The published name of the API within the multiparty network | string | . | message | The UUID of the broadcast message that was used to publish this API to the network | UUID | . | urls | The URLs to use to access the API | ContractURLs | . | published | Indicates if the API is published to other members of the multiparty network | bool | . ",
"content": "Contract APIs provide generated REST APIs for on-chain smart contracts. API endpoints are generated to invoke or perform query operations against each of the functions/methods implemented by the smart contract. API endpoints are also provided to add listeners to the events of that smart contract. Note that once you have established listeners for your blockchain events into FireFly, you need to also subscribe in your application to receive the FireFly events (of type blockchain_event_received) that are emitted for each detected blockchain event. For more information see the Events reference section. URL . The base path for your Contract API is: . | /api/v1/namespaces/{ns}/apis/{apiName} | . For the default namespace, this can be shortened to: . | /api/v1/apis/{apiName} | . FireFly Interface (FFI) and On-chain Location . Contract APIs are registered against: . | A FireFly Interface (FFI) definition, which defines in a blockchain agnostic format the list of functions/events supported by the smart contract. Also detailed type information about the inputs/outputs to those functions/events. | An optional location configured on the Contract API describes where the instance of the smart contract the API should interact with exists in the blockchain layer. For example the address of the Smart Contract for an Ethereum based blockchain, or the name and channel for a Hyperledger Fabric based blockchain. | . If the location is not specified on creation of the Contract API, then it must be specified on each API call made to the Contract API endpoints. OpenAPI V3 / Swagger Definitions . Each Contract API comes with an OpenAPI V3 / Swagger generated definition, which can be downloaded from: . | /api/v1/namespaces/{namespaces}/apis/{apiName}/api/swagger.json | . Swagger UI . A browser / exerciser UI for your API is also available on: . | /api/v1/namespaces/{namespaces}/apis/{apiName}/api | . Example . { \"id\": \"0f12317b-85a0-4a77-a722-857ea2b0a5fa\", \"namespace\": \"ns1\", \"interface\": { \"id\": \"c35d3449-4f24-4676-8e64-91c9e46f06c4\" }, \"location\": { \"address\": \"0x95a6c4895c7806499ba35f75069198f45e88fc69\" }, \"name\": \"my_contract_api\", \"message\": \"b09d9f77-7b16-4760-a8d7-0e3c319b2a16\", \"urls\": { \"api\": \"http://127.0.0.1:5000/api/v1/namespaces/default/apis/my_contract_api\", \"openapi\": \"http://127.0.0.1:5000/api/v1/namespaces/default/apis/my_contract_api/api/swagger.json\", \"ui\": \"http://127.0.0.1:5000/api/v1/namespaces/default/apis/my_contract_api/api\" }, \"published\": false } . Field Descriptions . | Field Name | Description | Type | . | id | The UUID of the contract API | UUID | . | namespace | The namespace of the contract API | string | . | interface | Reference to the FireFly Interface definition associated with the contract API | FFIReference | . | location | If this API is tied to an individual instance of a smart contract, this field can include a blockchain specific contract identifier. For example an Ethereum contract address, or a Fabric chaincode name and channel | JSONAny | . | name | The name that is used in the URL to access the API | string | . | networkName | The published name of the API within the multiparty network | string | . | message | The UUID of the broadcast message that was used to publish this API to the network | UUID | . | urls | The URLs to use to access the API | ContractURLs | . | published | Indicates if the API is published to other members of the multiparty network | bool | . ",
"url": "/firefly/head/reference/types/contractapi.html",
"relUrl": "/reference/types/contractapi.html"
},"293": {
Expand All @@ -1765,7 +1765,7 @@
},"294": {
"doc": "ContractAPI",
"title": "ContractURLs",
"content": "| Field Name | Description | Type | . | openapi | The URL to download the OpenAPI v3 (Swagger) description for the API generated in JSON or YAML format | string | . | ui | The URL to use in a web browser to access the SwaggerUI explorer/exerciser for the API | string | . ",
"content": "| Field Name | Description | Type | . | api | The URL to use to invoke the API | string | . | openapi | The URL to download the OpenAPI v3 (Swagger) description for the API generated in JSON or YAML format | string | . | ui | The URL to use in a web browser to access the SwaggerUI explorer/exerciser for the API | string | . ",
"url": "/firefly/head/reference/types/contractapi.html#contracturls",
"relUrl": "/reference/types/contractapi.html#contracturls"
},"295": {
Expand Down
6 changes: 6 additions & 0 deletions head/reference/types/contractapi.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -435,6 +435,7 @@ <h3 id="example">
</span><span class="nl">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my_contract_api"</span><span class="p">,</span><span class="w">
</span><span class="nl">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"b09d9f77-7b16-4760-a8d7-0e3c319b2a16"</span><span class="p">,</span><span class="w">
</span><span class="nl">"urls"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="nl">"api"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://127.0.0.1:5000/api/v1/namespaces/default/apis/my_contract_api"</span><span class="p">,</span><span class="w">
</span><span class="nl">"openapi"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://127.0.0.1:5000/api/v1/namespaces/default/apis/my_contract_api/api/swagger.json"</span><span class="p">,</span><span class="w">
</span><span class="nl">"ui"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://127.0.0.1:5000/api/v1/namespaces/default/apis/my_contract_api/api"</span><span class="w">
</span><span class="p">},</span><span class="w">
Expand Down Expand Up @@ -559,6 +560,11 @@ <h2 id="contracturls">
</tr>
</thead>
<tbody>
<tr>
<td><code class="language-plaintext highlighter-rouge">api</code></td>
<td>The URL to use to invoke the API</td>
<td><code class="language-plaintext highlighter-rouge">string</code></td>
</tr>
<tr>
<td><code class="language-plaintext highlighter-rouge">openapi</code></td>
<td>The URL to download the OpenAPI v3 (Swagger) description for the API generated in JSON or YAML format</td>
Expand Down
36 changes: 36 additions & 0 deletions head/swagger/swagger.yaml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -253,6 +256,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -315,6 +321,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -427,6 +436,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -551,6 +563,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -613,6 +628,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -11944,6 +11962,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -12075,6 +12096,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -12137,6 +12161,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -12263,6 +12290,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -12394,6 +12424,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down Expand Up @@ -12456,6 +12489,9 @@ paths:
urls:
description: The URLs to use to access the API
properties:
api:
description: The URL to use to invoke the API
type: string
openapi:
description: The URL to download the OpenAPI v3 (Swagger)
description for the API generated in JSON or YAML format
Expand Down

0 comments on commit 5ac34e2

Please sign in to comment.