Skip to content

Commit ee76e71

Browse files
committed
Rename ChannelPhase to Channel
In preparation for hiding ChannelPhase inside a Channel type, rename ChannelPhase to Channel.
1 parent d476742 commit ee76e71

File tree

4 files changed

+105
-105
lines changed

4 files changed

+105
-105
lines changed

lightning/src/ln/channel.rs

+50-50
Original file line numberDiff line numberDiff line change
@@ -1124,44 +1124,44 @@ impl_writeable_tlv_based!(PendingChannelMonitorUpdate, {
11241124
(0, update, required),
11251125
});
11261126

1127-
/// The `ChannelPhase` enum describes the current phase in life of a lightning channel with each of
1127+
/// The `Channel` enum describes the current phase in life of a lightning channel with each of
11281128
/// its variants containing an appropriate channel struct.
1129-
pub(super) enum ChannelPhase<SP: Deref> where SP::Target: SignerProvider {
1129+
pub(super) enum Channel<SP: Deref> where SP::Target: SignerProvider {
11301130
UnfundedOutboundV1(OutboundV1Channel<SP>),
11311131
UnfundedInboundV1(InboundV1Channel<SP>),
11321132
#[allow(dead_code)] // TODO(dual_funding): Remove once creating V2 channels is enabled.
11331133
UnfundedV2(PendingV2Channel<SP>),
11341134
Funded(FundedChannel<SP>),
11351135
}
11361136

1137-
impl<'a, SP: Deref> ChannelPhase<SP> where
1137+
impl<'a, SP: Deref> Channel<SP> where
11381138
SP::Target: SignerProvider,
11391139
<SP::Target as SignerProvider>::EcdsaSigner: ChannelSigner,
11401140
{
11411141
pub fn context(&'a self) -> &'a ChannelContext<SP> {
11421142
match self {
1143-
ChannelPhase::Funded(chan) => &chan.context,
1144-
ChannelPhase::UnfundedOutboundV1(chan) => &chan.context,
1145-
ChannelPhase::UnfundedInboundV1(chan) => &chan.context,
1146-
ChannelPhase::UnfundedV2(chan) => &chan.context,
1143+
Channel::Funded(chan) => &chan.context,
1144+
Channel::UnfundedOutboundV1(chan) => &chan.context,
1145+
Channel::UnfundedInboundV1(chan) => &chan.context,
1146+
Channel::UnfundedV2(chan) => &chan.context,
11471147
}
11481148
}
11491149

11501150
pub fn context_mut(&'a mut self) -> &'a mut ChannelContext<SP> {
11511151
match self {
1152-
ChannelPhase::Funded(ref mut chan) => &mut chan.context,
1153-
ChannelPhase::UnfundedOutboundV1(ref mut chan) => &mut chan.context,
1154-
ChannelPhase::UnfundedInboundV1(ref mut chan) => &mut chan.context,
1155-
ChannelPhase::UnfundedV2(ref mut chan) => &mut chan.context,
1152+
Channel::Funded(ref mut chan) => &mut chan.context,
1153+
Channel::UnfundedOutboundV1(ref mut chan) => &mut chan.context,
1154+
Channel::UnfundedInboundV1(ref mut chan) => &mut chan.context,
1155+
Channel::UnfundedV2(ref mut chan) => &mut chan.context,
11561156
}
11571157
}
11581158

11591159
pub fn unfunded_context_mut(&mut self) -> Option<&mut UnfundedChannelContext> {
11601160
match self {
1161-
ChannelPhase::Funded(_) => { debug_assert!(false); None },
1162-
ChannelPhase::UnfundedOutboundV1(chan) => Some(&mut chan.unfunded_context),
1163-
ChannelPhase::UnfundedInboundV1(chan) => Some(&mut chan.unfunded_context),
1164-
ChannelPhase::UnfundedV2(chan) => Some(&mut chan.unfunded_context),
1161+
Channel::Funded(_) => { debug_assert!(false); None },
1162+
Channel::UnfundedOutboundV1(chan) => Some(&mut chan.unfunded_context),
1163+
Channel::UnfundedInboundV1(chan) => Some(&mut chan.unfunded_context),
1164+
Channel::UnfundedV2(chan) => Some(&mut chan.unfunded_context),
11651165
}
11661166
}
11671167

@@ -1170,67 +1170,67 @@ impl<'a, SP: Deref> ChannelPhase<SP> where
11701170
}
11711171

11721172
pub fn as_funded(&self) -> Option<&FundedChannel<SP>> {
1173-
if let ChannelPhase::Funded(channel) = self {
1173+
if let Channel::Funded(channel) = self {
11741174
Some(channel)
11751175
} else {
11761176
None
11771177
}
11781178
}
11791179

11801180
pub fn as_funded_mut(&mut self) -> Option<&mut FundedChannel<SP>> {
1181-
if let ChannelPhase::Funded(channel) = self {
1181+
if let Channel::Funded(channel) = self {
11821182
Some(channel)
11831183
} else {
11841184
None
11851185
}
11861186
}
11871187

11881188
pub fn as_unfunded_outbound_v1_mut(&mut self) -> Option<&mut OutboundV1Channel<SP>> {
1189-
if let ChannelPhase::UnfundedOutboundV1(channel) = self {
1189+
if let Channel::UnfundedOutboundV1(channel) = self {
11901190
Some(channel)
11911191
} else {
11921192
None
11931193
}
11941194
}
11951195

11961196
pub fn is_unfunded_outbound_v1(&self) -> bool {
1197-
matches!(self, ChannelPhase::UnfundedOutboundV1(_))
1197+
matches!(self, Channel::UnfundedOutboundV1(_))
11981198
}
11991199

12001200
pub fn into_unfunded_outbound_v1(self) -> Result<OutboundV1Channel<SP>, Self> {
1201-
if let ChannelPhase::UnfundedOutboundV1(channel) = self {
1201+
if let Channel::UnfundedOutboundV1(channel) = self {
12021202
Ok(channel)
12031203
} else {
12041204
Err(self)
12051205
}
12061206
}
12071207

12081208
pub fn into_unfunded_inbound_v1(self) -> Result<InboundV1Channel<SP>, Self> {
1209-
if let ChannelPhase::UnfundedInboundV1(channel) = self {
1209+
if let Channel::UnfundedInboundV1(channel) = self {
12101210
Ok(channel)
12111211
} else {
12121212
Err(self)
12131213
}
12141214
}
12151215

12161216
pub fn as_unfunded_v2(&self) -> Option<&PendingV2Channel<SP>> {
1217-
if let ChannelPhase::UnfundedV2(channel) = self {
1217+
if let Channel::UnfundedV2(channel) = self {
12181218
Some(channel)
12191219
} else {
12201220
None
12211221
}
12221222
}
12231223

12241224
pub fn as_unfunded_v2_mut(&mut self) -> Option<&mut PendingV2Channel<SP>> {
1225-
if let ChannelPhase::UnfundedV2(channel) = self {
1225+
if let Channel::UnfundedV2(channel) = self {
12261226
Some(channel)
12271227
} else {
12281228
None
12291229
}
12301230
}
12311231

12321232
pub fn into_unfunded_v2(self) -> Option<PendingV2Channel<SP>> {
1233-
if let ChannelPhase::UnfundedV2(channel) = self {
1233+
if let Channel::UnfundedV2(channel) = self {
12341234
Some(channel)
12351235
} else {
12361236
None
@@ -1241,8 +1241,8 @@ impl<'a, SP: Deref> ChannelPhase<SP> where
12411241
&mut self, chain_hash: ChainHash, logger: &L,
12421242
) -> Option<SignerResumeUpdates> where L::Target: Logger {
12431243
match self {
1244-
ChannelPhase::Funded(chan) => Some(chan.signer_maybe_unblocked(logger)),
1245-
ChannelPhase::UnfundedOutboundV1(chan) => {
1244+
Channel::Funded(chan) => Some(chan.signer_maybe_unblocked(logger)),
1245+
Channel::UnfundedOutboundV1(chan) => {
12461246
let (open_channel, funding_created) = chan.signer_maybe_unblocked(chain_hash, logger);
12471247
Some(SignerResumeUpdates {
12481248
commitment_update: None,
@@ -1258,7 +1258,7 @@ impl<'a, SP: Deref> ChannelPhase<SP> where
12581258
shutdown_result: None,
12591259
})
12601260
},
1261-
ChannelPhase::UnfundedInboundV1(chan) => {
1261+
Channel::UnfundedInboundV1(chan) => {
12621262
let logger = WithChannelContext::from(logger, &chan.context, None);
12631263
let accept_channel = chan.signer_maybe_unblocked(&&logger);
12641264
Some(SignerResumeUpdates {
@@ -1275,38 +1275,38 @@ impl<'a, SP: Deref> ChannelPhase<SP> where
12751275
shutdown_result: None,
12761276
})
12771277
},
1278-
ChannelPhase::UnfundedV2(_) => None,
1278+
Channel::UnfundedV2(_) => None,
12791279
}
12801280
}
12811281

12821282
pub fn is_resumable(&self) -> bool {
12831283
match self {
1284-
ChannelPhase::Funded(_) => false,
1285-
ChannelPhase::UnfundedOutboundV1(chan) => chan.is_resumable(),
1286-
ChannelPhase::UnfundedInboundV1(_) => false,
1287-
ChannelPhase::UnfundedV2(_) => false,
1284+
Channel::Funded(_) => false,
1285+
Channel::UnfundedOutboundV1(chan) => chan.is_resumable(),
1286+
Channel::UnfundedInboundV1(_) => false,
1287+
Channel::UnfundedV2(_) => false,
12881288
}
12891289
}
12901290

12911291
pub fn maybe_get_open_channel<L: Deref>(
12921292
&mut self, chain_hash: ChainHash, logger: &L,
12931293
) -> Option<OpenChannelMessage> where L::Target: Logger {
12941294
match self {
1295-
ChannelPhase::Funded(_) => None,
1296-
ChannelPhase::UnfundedOutboundV1(chan) => {
1295+
Channel::Funded(_) => None,
1296+
Channel::UnfundedOutboundV1(chan) => {
12971297
let logger = WithChannelContext::from(logger, &chan.context, None);
12981298
chan.get_open_channel(chain_hash, &&logger)
12991299
.map(|msg| OpenChannelMessage::V1(msg))
13001300
},
1301-
ChannelPhase::UnfundedInboundV1(_) => {
1301+
Channel::UnfundedInboundV1(_) => {
13021302
// Since unfunded inbound channel maps are cleared upon disconnecting a peer,
13031303
// they are not persisted and won't be recovered after a crash.
13041304
// Therefore, they shouldn't exist at this point.
13051305
debug_assert!(false);
13061306
None
13071307
},
13081308
#[cfg(dual_funding)]
1309-
ChannelPhase::UnfundedV2(chan) => {
1309+
Channel::UnfundedV2(chan) => {
13101310
if chan.context.is_outbound() {
13111311
Some(OpenChannelMessage::V2(chan.get_open_channel_v2(chain_hash)))
13121312
} else {
@@ -1318,7 +1318,7 @@ impl<'a, SP: Deref> ChannelPhase<SP> where
13181318
}
13191319
},
13201320
#[cfg(not(dual_funding))]
1321-
ChannelPhase::UnfundedV2(_) => {
1321+
Channel::UnfundedV2(_) => {
13221322
debug_assert!(false);
13231323
None
13241324
},
@@ -1333,15 +1333,15 @@ impl<'a, SP: Deref> ChannelPhase<SP> where
13331333
L::Target: Logger,
13341334
{
13351335
match self {
1336-
ChannelPhase::Funded(_) => Ok(None),
1337-
ChannelPhase::UnfundedOutboundV1(chan) => {
1336+
Channel::Funded(_) => Ok(None),
1337+
Channel::UnfundedOutboundV1(chan) => {
13381338
let logger = WithChannelContext::from(logger, &chan.context, None);
13391339
chan.maybe_handle_error_without_close(chain_hash, fee_estimator, &&logger)
13401340
.map(|msg| Some(OpenChannelMessage::V1(msg)))
13411341
},
1342-
ChannelPhase::UnfundedInboundV1(_) => Ok(None),
1342+
Channel::UnfundedInboundV1(_) => Ok(None),
13431343
#[cfg(dual_funding)]
1344-
ChannelPhase::UnfundedV2(chan) => {
1344+
Channel::UnfundedV2(chan) => {
13451345
if chan.context.is_outbound() {
13461346
chan.maybe_handle_error_without_close(chain_hash, fee_estimator)
13471347
.map(|msg| Some(OpenChannelMessage::V2(msg)))
@@ -1350,51 +1350,51 @@ impl<'a, SP: Deref> ChannelPhase<SP> where
13501350
}
13511351
},
13521352
#[cfg(not(dual_funding))]
1353-
ChannelPhase::UnfundedV2(_) => {
1353+
Channel::UnfundedV2(_) => {
13541354
debug_assert!(false);
13551355
Ok(None)
13561356
},
13571357
}
13581358
}
13591359
}
13601360

1361-
impl<SP: Deref> From<OutboundV1Channel<SP>> for ChannelPhase<SP>
1361+
impl<SP: Deref> From<OutboundV1Channel<SP>> for Channel<SP>
13621362
where
13631363
SP::Target: SignerProvider,
13641364
<SP::Target as SignerProvider>::EcdsaSigner: ChannelSigner,
13651365
{
13661366
fn from(channel: OutboundV1Channel<SP>) -> Self {
1367-
ChannelPhase::UnfundedOutboundV1(channel)
1367+
Channel::UnfundedOutboundV1(channel)
13681368
}
13691369
}
13701370

1371-
impl<SP: Deref> From<InboundV1Channel<SP>> for ChannelPhase<SP>
1371+
impl<SP: Deref> From<InboundV1Channel<SP>> for Channel<SP>
13721372
where
13731373
SP::Target: SignerProvider,
13741374
<SP::Target as SignerProvider>::EcdsaSigner: ChannelSigner,
13751375
{
13761376
fn from(channel: InboundV1Channel<SP>) -> Self {
1377-
ChannelPhase::UnfundedInboundV1(channel)
1377+
Channel::UnfundedInboundV1(channel)
13781378
}
13791379
}
13801380

1381-
impl<SP: Deref> From<PendingV2Channel<SP>> for ChannelPhase<SP>
1381+
impl<SP: Deref> From<PendingV2Channel<SP>> for Channel<SP>
13821382
where
13831383
SP::Target: SignerProvider,
13841384
<SP::Target as SignerProvider>::EcdsaSigner: ChannelSigner,
13851385
{
13861386
fn from(channel: PendingV2Channel<SP>) -> Self {
1387-
ChannelPhase::UnfundedV2(channel)
1387+
Channel::UnfundedV2(channel)
13881388
}
13891389
}
13901390

1391-
impl<SP: Deref> From<FundedChannel<SP>> for ChannelPhase<SP>
1391+
impl<SP: Deref> From<FundedChannel<SP>> for Channel<SP>
13921392
where
13931393
SP::Target: SignerProvider,
13941394
<SP::Target as SignerProvider>::EcdsaSigner: ChannelSigner,
13951395
{
13961396
fn from(channel: FundedChannel<SP>) -> Self {
1397-
ChannelPhase::Funded(channel)
1397+
Channel::Funded(channel)
13981398
}
13991399
}
14001400

0 commit comments

Comments
 (0)