- Experimental and not yet supported on current Splice: the accept leg can’t
- reference the transfer leg’s instruction within one batch, so the submit
- errors and nothing commits. Uncheck to use the working sequential offer→accept path.
-
- )}
{plan && (
diff --git a/internal/cli/localnet/token/faucet.go b/internal/cli/localnet/token/faucet.go
index b51d4ef9..97bf7e47 100644
--- a/internal/cli/localnet/token/faucet.go
+++ b/internal/cli/localnet/token/faucet.go
@@ -19,9 +19,10 @@ func buildFaucet() *cobra.Command {
Short: "Fund a party from a well-known source (auto-accepted)",
Long: `Transfer
of an instrument from a funded source party to
, auto-accepting the resulting TransferInstruction so the target is
-funded in one step. The source defaults to the role's own funded party
-(e.g. app-user holds the network's Amulet) — pass --source to fund from a
-different holder, such as a created token's issuer.
+funded in one step. The source defaults to the instrument's largest current
+holder — the network's Amulet party for Amulet, or wherever a created
+token's supply was minted — so pass --source only to fund from a specific
+holder.
and --source accept aliases. Requires --endpoint and --instrument.`,
Args: cobra.ExactArgs(2),
@@ -38,7 +39,7 @@ different holder, such as a created token's issuer.
}
cmd.Flags().StringVar(&opts.Instance, "instance", "", "Instance name. Required.")
cmd.Flags().StringVar(&opts.Instrument, "instrument", "", "Instrument symbol or raw id. Required.")
- cmd.Flags().StringVar(&opts.Source, "source", "", "Funding party (alias or id). Empty defaults to the role's own funded party.")
+ cmd.Flags().StringVar(&opts.Source, "source", "", "Funding party (alias or id). Empty defaults to the instrument's largest holder.")
cmd.Flags().StringVar(&opts.Endpoint, "endpoint", "", "Participant gRPC endpoint (host:port). Required for the live transfer.")
cmd.Flags().StringVar(&opts.Token, "token", "", "Bearer JWT. Empty auto-issues a per-role token.")
cmd.Flags().StringVar(&opts.Role, "role", "app-user", "Role whose JWT authenticates the submit.")
diff --git a/internal/localnet/token/faucet.go b/internal/localnet/token/faucet.go
index f832e968..7626e844 100644
--- a/internal/localnet/token/faucet.go
+++ b/internal/localnet/token/faucet.go
@@ -3,6 +3,7 @@ package token
import (
"context"
"io"
+ "math/big"
)
// FaucetOptions funds a party from a well-known source. A thin wrapper
@@ -28,6 +29,43 @@ type FaucetOptions struct {
// defaults to the role's own party (its seeded alias, e.g. "app-user",
// which holds the network's Amulet) — pass Source explicitly to fund from
// a different holder (e.g. the issuer of a created token).
+// defaultFaucetSource picks the party to dispense from when the caller
+// didn't name one: the largest current holder of the instrument.
+//
+// The role's own party is only a sensible default for Amulet, which the
+// LocalNet bootstrap funds. A token created here starts with its supply
+// wherever it was minted — often a dedicated holder — so defaulting to the
+// role party made the faucet fail with "sender holds no units of this
+// instrument" for every user-created instrument. Falls back to the role
+// party when nothing holds the instrument yet, which surfaces that same
+// (now accurate) error.
+func defaultFaucetSource(ctx context.Context, opts FaucetOptions) string {
+ fallback := roleOrDefault(opts.Role)
+ endpoint := opts.Endpoint
+ if endpoint == "" {
+ endpoint = ResolveLedgerEndpoint(opts.Instance, roleOrDefault(opts.Role))
+ }
+ if endpoint == "" {
+ return fallback
+ }
+ ref := instrumentRefOrRaw(opts.Instance, opts.Instrument)
+ sum, err := RunInstrumentSummary(ctx, BalanceOptions{
+ Instance: opts.Instance, Role: roleOrDefault(opts.Role), Insecure: opts.Insecure,
+ Endpoint: endpoint, Instrument: ref.InstrumentID,
+ })
+ if err != nil {
+ return fallback
+ }
+ // Holders come back biggest-first, so the first non-zero entry is the
+ // party best able to cover the requested amount.
+ for _, h := range sum.Holders {
+ if r, ok := new(big.Rat).SetString(zeroIfEmpty(h.Balance)); ok && r.Sign() > 0 {
+ return h.Party
+ }
+ }
+ return fallback
+}
+
func RunFaucet(ctx context.Context, out io.Writer, opts FaucetOptions) error {
if err := requireFields("faucet", "instance", opts.Instance, "instrument", opts.Instrument,
"recipient party", opts.To, "amount", opts.Amount); err != nil {
@@ -35,8 +73,7 @@ func RunFaucet(ctx context.Context, out io.Writer, opts FaucetOptions) error {
}
source := opts.Source
if source == "" {
- // The role's seeded alias resolves to its own funded party.
- source = roleOrDefault(opts.Role)
+ source = defaultFaucetSource(ctx, opts)
}
return RunTransfer(ctx, out, TransferOptions{
Instance: opts.Instance,