Skip to content

Add multiplier-ticket-cli workspace - #1247

Merged
michaeldjeffrey merged 1 commit into
mainfrom
mj/multiplier-ticket-cli
Sep 3, 2026
Merged

Add multiplier-ticket-cli workspace#1247
michaeldjeffrey merged 1 commit into
mainfrom
mj/multiplier-ticket-cli

Conversation

@michaeldjeffrey

Copy link
Copy Markdown
Contributor

With a single subcommand submit, sign and send a data transfer multiplier ticket to ingest for HIP-150 value multipliers.

https://github.com/helium/HIP/blob/main/0150-mobile-deployer-prioritization.md

Usage:

multiplier-ticket-cli \
    --keypair ./keypair.bin \
    --ingest-url INGEST_URL \
    submit \
    --hotspot <B58> \
    --multiplier 1.5 \
    --message "testing"
    [--commit]

Sample Output:

{
  "committed": false,
  "hotspot_pubkey": "13fZvTpwLnGaKKiHhAuTnarbq2ohNCiexbyEdeSn13vTH2dfcDE",
  "message": "test message",
  "multiplier": "1.5",
  "signed_timestamp": "2026-09-02T22:36:28.190Z",
  "signer": "13fZvTpwLnGaKKiHhAuTnarbq2ohNCiexbyEdeSn13vTH2dfcDE"
}

Without --commit nothing is sent.

Tickets cannot be withdrawn, to reset a multiplier for a hotspot, submit a ticket with a 1 multiplier value.

To check the active status of a ticket, see README.md for a query to run in trino.

Mulitplier ranges between 1-5 are enforced in this CLI as well as in mobile-packet-verifier when tickets are ingested.

The signing key used for tickets must be present in the ingest settings under Settings.data_transfer_multiplier_authorized_keys, and in mobile-packet-verifier under Settings.multiplier.authorized_keys.

With a single subcommand `submit`, sign and send a data transfer
multiplier ticket to ingest for HIP-150 value multipliers.

https://github.com/helium/HIP/blob/main/0150-mobile-deployer-prioritization.md

Usage:
```sh
multiplier-ticket-cli \
    --keypair ./keypair.bin \
    --ingest-url INGEST_URL \
    submit \
    --hotspot <B58> \
    --multiplier 1.5 \
    --message "testing"
    [--commit]
```

Sample Output:
```json
{
  "committed": false,
  "hotspot_pubkey": "13fZvTpwLnGaKKiHhAuTnarbq2ohNCiexbyEdeSn13vTH2dfcDE",
  "message": "test message",
  "multiplier": "1.5",
  "signed_timestamp": "2026-09-02T22:36:28.190Z",
  "signer": "13fZvTpwLnGaKKiHhAuTnarbq2ohNCiexbyEdeSn13vTH2dfcDE"
}
```

Without `--commit` nothing is sent.

Tickets cannot be withdrawn, to reset a multiplier for a hotspot,
submit a ticket with a `1` multiplier value.

To check the active status of a ticket, see README.md for a query to
run in trino.

Mulitplier ranges between 1-5 are enforced in this CLI as well as in
mobile-packet-verifier when tickets are ingested.

The signing key used for tickets must be present in the ingest
settings under `Settings.data_transfer_multiplier_authorized_keys`,
and in mobile-packet-verifier under `Settings.multiplier.authorized_keys`.
@michaeldjeffrey
michaeldjeffrey merged commit 15ad938 into main Sep 3, 2026
29 checks passed
@michaeldjeffrey
michaeldjeffrey deleted the mj/multiplier-ticket-cli branch September 3, 2026 16:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants