Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .go-algorand-stable.version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v4.1.1-stable
v4.1.2-stable
2 changes: 1 addition & 1 deletion docs/clis/goal/app/box/box.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ goal app box [flags]

* [goal app](../../../app/app/) - Manage applications
* [goal app box info](../info/) - Retrieve information about an application box.
* [goal app box list](../list/) - List application boxes belonging to an application
* [goal app box list](../list/) - List all application boxes belonging to an application



18 changes: 7 additions & 11 deletions docs/clis/goal/app/box/list.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,19 @@ title: goal app box list



List application boxes belonging to an application
List all application boxes belonging to an application



### Synopsis



List application boxes belonging to an application.
List all application boxes belonging to an application.

Printable names and values are formatted as 'str:hello' otherwise 'b64:A=='.
For printable strings, the box name is formatted as 'str:hello'

For everything else, the box name is formatted as 'b64:A=='.



Expand All @@ -32,15 +34,9 @@ goal app box list [flags]

```

-h, --help help for list

-l, --limit uint The maximum number of boxes to list. 0 means no limit.

-n, --next string The next-token returned from a previous call, used for pagination.

-p, --prefix string Return only boxes that begin with the supplied prefix.
-h, --help help for list

-v, --values Request and display box values.
-m, --max uint Maximum number of boxes to list. 0 means no limit.

```

Expand Down
4 changes: 2 additions & 2 deletions docs/get-details/algorand-networks/mainnet.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
title: MainNet

# Version
`v4.1.1-stable`
`v4.1.2-stable`

# Release Version
https://github.com/algorand/go-algorand/releases/tag/v4.1.1-stable
https://github.com/algorand/go-algorand/releases/tag/v4.1.2-stable

# Genesis ID
`mainnet-v1.0`
Expand Down
4 changes: 2 additions & 2 deletions docs/get-details/algorand-networks/testnet.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
title: TestNet

# Version
`v4.1.1-stable`
`v4.1.2-stable`

# Release Version
https://github.com/algorand/go-algorand/releases/tag/v4.1.1-stable
https://github.com/algorand/go-algorand/releases/tag/v4.1.2-stable

# Genesis ID
`testnet-v1.0`
Expand Down
46 changes: 31 additions & 15 deletions docs/rest-apis/algod.md
Original file line number Diff line number Diff line change
Expand Up @@ -569,32 +569,29 @@ Given an application ID and box name, it returns the round, box name, and value

<a name="getapplicationboxes"></a>
### GET /v2/applications/{application-id}/boxes
Get boxes for a given application.
Get all box names for a given application.
```
GET /v2/applications/{application-id}/boxes
```


**Description**
Given an application ID, return boxes in lexographical order by name. If the results must be truncated, a next-token is supplied to continue the request.
Given an application ID, return all Box names. No particular ordering is guaranteed. Request fails when client or server-side configured limits prevent returning all Box names.


**Parameters**

|Type|Name|Description|Schema|
|---|---|---|---|
|**Path**|**application-id** <br>*required*|An application identifier|integer|
|**Query**|**max** <br>*optional*|Maximum number of boxes to return. Server may impose a lower limit.|integer|
|**Query**|**next** <br>*optional*|A box name, in the goal app call arg form 'encoding:value'. When provided, the returned boxes begin (lexographically) with the supplied name. Callers may implement pagination by reinvoking the endpoint with the token from a previous call's next-token.|string|
|**Query**|**prefix** <br>*optional*|A box name prefix, in the goal app call arg form 'encoding:value'. For ints, use the form 'int:1234'. For raw bytes, use the form 'b64:A=='. For printable strings, use the form 'str:hello'. For addresses, use the form 'addr:XYZ...'.|string|
|**Query**|**values** <br>*optional*|If true, box values will be returned.|boolean|
|**Query**|**max** <br>*optional*|Max number of box names to return. If max is not set, or max == 0, returns all box-names.|integer|


**Responses**

|HTTP Code|Description|Schema|
|---|---|---|
|**200**|Boxes of an application|[Response 200](#getapplicationboxes-response-200)|
|**200**|Box names of an application|[Response 200](#getapplicationboxes-response-200)|
|**400**|Bad Request|[ErrorResponse](#errorresponse)|
|**401**|Invalid API Token|[ErrorResponse](#errorresponse)|
|**500**|Internal Error|[ErrorResponse](#errorresponse)|
Expand All @@ -603,11 +600,9 @@ Given an application ID, return boxes in lexographical order by name. If the res
<a name="getapplicationboxes-response-200"></a>
**Response 200**

|Name|Description|Schema|
|---|---|---|
|**boxes** <br>*required*||< [Box](#box) > array|
|**next-token** <br>*optional*|Used for pagination, when making another request provide this token with the next parameter.|string|
|**round** <br>*required*|The round for which this information is relevant.|integer|
|Name|Schema|
|---|---|
|**boxes** <br>*required*|< [BoxDescriptor](#boxdescriptor) > array|


**Produces**
Expand Down Expand Up @@ -2662,9 +2657,19 @@ Box name and its content.

|Name|Description|Schema|
|---|---|---|
|**name** <br>*required*|The box name, base64 encoded <br>**Pattern** : `"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"`|string (byte)|
|**round** <br>*optional*|The round for which this information is relevant|integer|
|**value** <br>*required*|The box value, base64 encoded. <br>**Pattern** : `"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"`|string (byte)|
|**name** <br>*required*|\[name\] box name, base64 encoded <br>**Pattern** : `"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"`|string (byte)|
|**round** <br>*required*|The round for which this information is relevant|integer|
|**value** <br>*required*|\[value\] box value, base64 encoded. <br>**Pattern** : `"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"`|string (byte)|


<a name="boxdescriptor"></a>
### BoxDescriptor
Box descriptor describes a Box.


|Name|Description|Schema|
|---|---|---|
|**name** <br>*required*|Base64 encoded box name <br>**Pattern** : `"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"`|string (byte)|


<a name="boxreference"></a>
Expand Down Expand Up @@ -2839,6 +2844,17 @@ Key-value pairs for StateDelta.
|**voteLst** <br>*optional*|integer (uint64)|


<a name="kvdelta"></a>
### KvDelta
A single Delta containing the key, the previous value and the current value for a single round.


|Name|Description|Schema|
|---|---|---|
|**key** <br>*optional*|The key, base64 encoded. <br>**Pattern** : `"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"`|string (byte)|
|**value** <br>*optional*|The new value of the KV store entry, base64 encoded. <br>**Pattern** : `"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"`|string (byte)|


<a name="ledgerstatedelta"></a>
### LedgerStateDelta
Ledger StateDelta object
Expand Down