{
  "$schema": "../rpc-schema-draft.json",
  "type": "object",
  "additionalProperties": false,
  "rpc": "askrene-create-channel",
  "title": "Command to add a channel to layer (EXPERIMENTAL)",
  "description": [
    "WARNING: experimental, so API may change.",
    "",
    "The **askrene-create-channel** RPC command tells askrene to populate one direction of a channel in the given layer.  If the channel already exists, it will be overridden.  If the layer does not exist, it will be created."
  ],
  "request": {
    "required": [
      "layer",
      "source",
      "destination",
      "short_channel_id",
      "capacity_msat",
      "htlc_min",
      "htlc_max",
      "base_fee",
      "proportional_fee",
      "delay"
    ],
    "properties": {
      "layer": {
        "type": "string",
        "description": [
          "The name of the layer to apply this change to."
        ]
      },
      "source": {
        "type": "pubkey",
        "description": [
          "The source node id for the channel."
        ]
      },
      "destination": {
        "type": "pubkey",
        "description": [
          "The destination node id for the channel."
        ]
      },
      "short_channel_id": {
        "type": "short_channel_id",
        "description": [
          "The short channel id for the channel.  If a channel with this short channel id already exists in *layer*, the *source*, *destination* and *capacity_msat* must be the same."
        ]
      },
      "capacity_msat": {
        "type": "msat",
        "description": [
          "The capacity (onchain size) of the channel."
        ]
      },
      "htlc_min": {
        "type": "msat",
        "description": [
          "The minimum value allowed in this direction."
        ]
      },
      "htlc_max": {
        "type": "msat",
        "description": [
          "The maximum value allowed in this direction."
        ]
      },
      "base_fee": {
        "type": "msat",
        "description": [
          "The base fee to apply to use the channel in this direction."
        ]
      },
      "proportional_fee": {
        "type": "u32",
        "description": [
          "The proportional fee (in parts per million) to apply to use the channel in this direction."
        ]
      },
      "delay": {
        "type": "u16",
        "description": [
          "The CLTV delay required for this direction."
        ]
      }
    }
  },
  "response": {
    "required": [],
    "properties": {}
  },
  "see_also": [
    "lightning-getroutes(7)",
    "lightning-askrene-disable-node(7)",
    "lightning-askrene-inform-channel(7)",
    "lightning-askrene-listlayers(7)",
    "lightning-askrene-age(7)"
  ],
  "author": [
    "Rusty Russell <<rusty@rustcorp.com.au>> is mainly responsible."
  ],
  "resources": [
    "Main web site: <https://github.com/ElementsProject/lightning>"
  ]
}