Launchtube

https://github.com/stellar/launchtube
Admin
Launchtube is a service that simplifies submitting Soroban smart contract invocations to the Stellar...
Tokens:1,602
Snippets:14
Trust Score:9.4
Update:1 year ago
Show doc for...
Tokens:
Raw
### Claim Token Webpage (GET /claim)

Source: https://github.com/stellar/launchtube/blob/main/README.md

Webpage form to create and activate a new token using a provided claim code.

```APIDOC
Method: GET /claim
Query:
  code: String - The {claim code} you were given and wish to use to create and activate a new token with.
```

--------------------------------

### Activate Token Webpage (GET /activate)

Source: https://github.com/stellar/launchtube/blob/main/README.md

Webpage form to activate a given JWT token, enabling its usage with the API.

```APIDOC
Method: GET /activate
Query:
  token: String - The {jwt token} you were given and wish to activate.
```

--------------------------------

### Activate Token API (POST /activate)

Source: https://github.com/stellar/launchtube/blob/main/README.md

API endpoint used by the GET /activate webpage form to activate a JWT token.

```APIDOC
Method: POST /activate
Headers:
  Content-Type: x-www-form-urlencoded
Body:
  token: String - The {jwt token} you were given and wish to activate.
```

--------------------------------

### Generate QR Code (GET /qrcode)

Source: https://github.com/stellar/launchtube/blob/main/README.md

Private endpoint to generate a QR code for a new JWT token.

```APIDOC
Method: GET /qrcode
```

--------------------------------

### Get Remaining Credits (GET /info)

Source: https://github.com/stellar/launchtube/blob/main/README.md

Retrieves the numeric value of remaining credits (stroops) available for the authenticated token.

```APIDOC
Method: GET /info
Return: String - Numeric value of the token's remaining credits (stroops).
```

--------------------------------

### Claim Token API (POST /claim)

Source: https://github.com/stellar/launchtube/blob/main/README.md

API endpoint used by the GET /claim webpage form to create and activate new tokens via claim codes.

```APIDOC
Method: POST /claim
Headers:
  Content-Type: x-www-form-urlencoded
Body:
  code: String - The {claim code} you were given and wish to use to create and activate a new token with.
Return: HTML page - An HTML page containing the newly activated token that can be used for authentication.
```

--------------------------------

### Get Sequencer Durable Object Info (GET /seq)

Source: https://github.com/stellar/launchtube/blob/main/README.md

Retrieves information about the sequencer Durable Object. This endpoint is primarily intended for system maintainers for health or debug checks and is generally not needed for typical usage.

```APIDOC
GET /seq
  Description: Get information about the sequencer Durable Object.
  Body Parameters:
    - Refer to endpoint code for available parameters: ./src/api/sequencer-info.ts
  Return:
    JSON object with information about the sequencer. Refer to code for exact shape.
```

--------------------------------

### Generate Credit JWT Tokens (GET /gen)

Source: https://github.com/stellar/launchtube/blob/main/README.md

Generates a list of new credit JWT tokens. You can specify the token's time-to-live, credit spending limit (in stroops), and the number of unique tokens to generate (max 100).

```APIDOC
GET /gen
  Description: Generate a list of new credit JWT tokens.
  Query Parameters:
    - ttl: number The number of seconds these tokens should live for
    - credits: number The number of credits these tokens can spend (in stroops)
    - count: number The number of unique new tokens to generate (max of 100)
  Return:
    JSON array of tokens
```

--------------------------------

### Generate QR Code for Token Claim

Source: https://github.com/stellar/launchtube/blob/main/README.md

Generates a PNG QR code image that links to a token claim page. This endpoint allows specifying token lifetime, XLM spend limit, and an option to redirect directly to the claim link. Requires an Authorization header for SDF members.

```APIDOC
GET /qr (Implicit)
  Description: Generates a PNG QR code image for token claims.
  Query Parameters:
    - ttl: number The number of seconds these tokens should live for
    - xlm: number The number of xlm this tokens can spend
    - claim: boolean Boolean value to redirect away from the QR page right to the claim link page
  Headers:
    - Authorization: String (Required for SDF members)
  Return:
    PNG QR code image linking to {location.origin}/claim?code={claim code}
  Return Headers:
    - X-Claim-Code: String The claim code you can use to create new tokens
```

--------------------------------

### Run SQL Query (POST /sql)

Source: https://github.com/stellar/launchtube/blob/main/README.md

Executes a SQL query directly on the database. This endpoint does not perform any query validation, so caution is advised to avoid database corruption. Supports positional arguments for the query.

```APIDOC
POST /sql
  Description: Run a SQL query on the database.
  Body Parameters:
    - query: string SQL query you want to run. e.g. `SELECT * FROM Transactions LIMIT 100`
    - args: array Positional arguments for the query. Include as strings in an array. e.g. `["arg1", "arg2"]`
  Headers:
    - Content-Type: x-www-form-urlencoded
  Return:
    JSON array of results from the query (if any)
  Example:
    [
        {
            "Sub": "712f3af6061d26ac4c573151e116547a3b58b364fcf5a6df8f1a5916d540cae3",
            "Tx": "40833f9c1b6e3187f7ff915a2bbad55e422650a283d3d13d941a5eaf81abaed7"
        },
        {
            "Sub": "712f3af6061d26ac4c573151e116547a3b58b364fcf5a6df8f1a5916d540cae3",
            "Tx": "f5b4d4638944ffab6ca693fe4036275c4822dd46e7e0f558a4e53a38f704fb45"
        }
    ]
```

--------------------------------

### Public API Authorization Header

Source: https://github.com/stellar/launchtube/blob/main/README.md

Details for authenticating public API requests using a JWT token. Tokens for Testnet can be generated via a webpage, while Mainnet tokens require a request on Discord.

```APIDOC
Header:
  Authorization: Bearer {jwt token}
```

--------------------------------

### Submit Stellar Transaction (POST /)

Source: https://github.com/stellar/launchtube/blob/main/README.md

Endpoint to submit a Stellar transaction or Soroban host function to the network. This service handles fee management and simulation, with credits spent progressively as the transaction moves through the backend.

```APIDOC
Method: POST /
Headers:
  Content-Type: x-www-form-urlencoded
Body (one of the following is required):
  xdr: String - Transaction you want submitted as an XDR encoded String
  func: String - xdr.HostFunction encoded as an XDR String
  auth: Array of Strings - xdr.SorobanAuthorizationEntry encoded XDR Strings
Optional Body:
  sim: Boolean (default true) - Flag for Launchtube to handle simulation. If false, transaction timeout must be <= 30 seconds and inclusion fee <= 201 stroops.
Return: JSON - Response of the transaction submission if successful, otherwise a JSON error.
Return Headers:
  X-Credits-Remaining: String - Numeric value of the token's remaining credits (stroops).
```

--------------------------------

### Private API Authorization Header

Source: https://github.com/stellar/launchtube/blob/main/README.md

Authorization details for private API endpoints, requiring an internal authentication token. Access is restricted to SDF members.

```APIDOC
Header:
  Authorization: Bearer {auth token}
```

--------------------------------

### Delete Credit JWT Token (DELETE /:sub)

Source: https://github.com/stellar/launchtube/blob/main/README.md

Deletes a previously generated token. The token is identified by its JWT `sub` claim, which must be provided as a path parameter.

```APIDOC
DELETE /:sub
  Description: Delete a previously generated token.
  Path Parameters:
    - sub: string The JWT `sub` claim of the token you want to delete
  Return:
    OK
```
Tokens:
Raw